Plane's Official Model Context Protocol Server 🔌 ⌨️ 🔥
The Plane MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with Plane APIs, enabling projects, work items, and automations capabilities for develops and AI interfaces.
PLANE_API_KEY
- The user’s API token. This can be obtained from the /settings/api-tokens/
page in the UI.PLANE_WORKSPACE_SLUG
- The workspace slug for your Plane instance.PLANE_API_HOST_URL
(optional) - The host URL of the Plane API Server. Defaults to https://api.plane.so/get_user
- Get the current user’s information
get_projects
- Get all projects for the current user
create_project
- Create a new project
name
: Project name (string, required)list_issue_types
- Get all issue types for a specific project
project_id
: UUID of the project (string, required)get_issue_type
- Get details of a specific issue type
project_id
: UUID of the project (string, required)type_id
: UUID of the issue type (string, required)create_issue_type
- Create a new issue type in a project
project_id
: UUID of the project (string, required)issue_type_data
: Object containing:
name
: Name of the issue type (string, required)description
: Description of the issue type (string, required)update_issue_type
- Update an existing issue type
project_id
: UUID of the project (string, required)type_id
: UUID of the issue type (string, required)issue_type_data
: Fields to update on the issue type (object)delete_issue_type
- Delete an issue type
project_id
: UUID of the project (string, required)type_id
: UUID of the issue type (string, required)list_states
- Get all states for a specific project
project_id
: UUID of the project (string, required)get_state
- Get details of a specific state
project_id
: UUID of the project (string, required)state_id
: UUID of the state (string, required)create_state
- Create a new state in a project
project_id
: UUID of the project (string, required)state_data
: Object containing:
name
: Name of the state (string, required)color
: Color code for the state (string, required)update_state
- Update an existing state
project_id
: UUID of the project (string, required)state_id
: UUID of the state (string, required)state_data
: Fields to update on the state (object)delete_state
- Delete a state
project_id
: UUID of the project (string, required)state_id
: UUID of the state (string, required)list_labels
- Get all labels for a specific project
project_id
: UUID of the project (string, required)get_label
- Get details of a specific label
project_id
: UUID of the project (string, required)label_id
: UUID of the label (string, required)create_label
- Create a new label in a project
project_id
: UUID of the project (string, required)label_data
: Object containing:
name
: Name of the label (string, required)color
: Color code for the label (string, required)update_label
- Update an existing label
project_id
: UUID of the project (string, required)label_id
: UUID of the label (string, required)label_data
: Fields to update on the label (object)delete_label
- Delete a label
project_id
: UUID of the project (string, required)label_id
: UUID of the label (string, required)get_issue_using_readable_identifier
- Get issue details using readable identifier (e.g., PROJ-123)
project_identifier
: Project identifier (e.g., “PROJ”) (string, required)issue_identifier
: Issue number (e.g., “123”) (string, required)get_issue_comments
- Get all comments for a specific issue
project_id
: UUID of the project (string, required)issue_id
: UUID of the issue (string, required)add_issue_comment
- Add a comment to an issue
project_id
: UUID of the project (string, required)issue_id
: UUID of the issue (string, required)comment_html
: HTML content of the comment (string, required)create_issue
- Create a new issue
project_id
: UUID of the project (string, required)issue_data
: Object containing:
name
: Title of the issue (string, required)description_html
: HTML description of the issue (string, required)update_issue
- Update an existing issue
project_id
: UUID of the project (string, required)issue_id
: UUID of the issue (string, required)issue_data
: Fields to update on the issue (object)list_modules
- Get all modules for a specific project
project_id
: UUID of the project (string, required)get_module
- Get details of a specific module
project_id
: UUID of the project (string, required)module_id
: UUID of the module (string, required)create_module
- Create a new module in a project
project_id
: UUID of the project (string, required)module_data
: Object containing:
name
: Name of the module (string, required)update_module
- Update an existing module
project_id
: UUID of the project (string, required)module_id
: UUID of the module (string, required)module_data
: Fields to update on the module (object)delete_module
- Delete a module
project_id
: UUID of the project (string, required)module_id
: UUID of the module (string, required)list_module_issues
- Get all issues for a specific module
project_id
: UUID of the project (string, required)module_id
: UUID of the module (string, required)add_module_issues
- Add issues to a module
project_id
: UUID of the project (string, required)module_id
: UUID of the module (string, required)issues
: Array of issue UUIDs to add (string[], required)delete_module_issue
- Remove an issue from a module
project_id
: UUID of the project (string, required)module_id
: UUID of the module (string, required)issue_id
: UUID of the issue to remove (string, required)list_cycles
- Get all cycles for a specific project
project_id
: UUID of the project (string, required)get_cycle
- Get details of a specific cycle
project_id
: UUID of the project (string, required)cycle_id
: UUID of the cycle (string, required)create_cycle
- Create a new cycle in a project
project_id
: UUID of the project (string, required)cycle_data
: Object containing:
name
: Name of the cycle (string, required)start_date
: Start date (YYYY-MM-DD) (string, required)end_date
: End date (YYYY-MM-DD) (string, required)update_cycle
- Update an existing cycle
project_id
: UUID of the project (string, required)cycle_id
: UUID of the cycle (string, required)cycle_data
: Fields to update on the cycle (object)delete_cycle
- Delete a cycle
project_id
: UUID of the project (string, required)cycle_id
: UUID of the cycle (string, required)list_cycle_issues
- Get all issues for a specific cycle
project_id
: UUID of the project (string, required)cycle_id
: UUID of the cycle (string, required)add_cycle_issues
- Add issues to a cycle
project_id
: UUID of the project (string, required)cycle_id
: UUID of the cycle (string, required)issues
: Array of issue UUIDs to add (string[], required)delete_cycle_issue
- Remove an issue from a cycle
project_id
: UUID of the project (string, required)cycle_id
: UUID of the cycle (string, required)issue_id
: UUID of the issue to remove (string, required)get_issue_worklogs
- Get all worklogs for a specific issue
project_id
: UUID of the project (string, required)issue_id
: UUID of the issue (string, required)get_total_worklogs
- Get total logged time for a project
project_id
: UUID of the project (string, required)create_worklog
- Create a new worklog for an issue
project_id
: UUID of the project (string, required)issue_id
: UUID of the issue (string, required)worklog_data
: Object containing:
description
: Description of the work done (string, required)duration
: Duration in minutes (integer, required)update_worklog
- Update an existing worklog
project_id
: UUID of the project (string, required)issue_id
: UUID of the issue (string, required)worklog_id
: UUID of the worklog (string, required)worklog_data
: Fields to update on the worklog (object)delete_worklog
- Delete a worklog
project_id
: UUID of the project (string, required)issue_id
: UUID of the issue (string, required)worklog_id
: UUID of the worklog (string, required)Add Plane to Claude Desktop by editing your claude_desktop_config.json
.
{
"mcpServers": {
"plane": {
"command": "npx",
"args": [
"-y",
"@makeplane/plane-mcp-server"
],
"env": {
"PLANE_API_KEY": "<YOUR_API_KEY>",
"PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED",
"PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
}
}
}
}
Add Plane to VSCode by editing your .vscode.json/mcp.json
.
{
"servers": {
"plane": {
"command": "npx",
"args": [
"-y",
"@makeplane/plane-mcp-server"
],
"env": {
"PLANE_API_KEY": "<YOUR_API_KEY>",
"PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED",
"PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
}
}
}
}
This project is licensed under the terms of the MIT open source license.
Mcp Guide
A beginner-friendly guide server that helps users understand MCP concepts, provides interactive examples, and demonstrates best practices for building MCP integrations. Features tools for exploring MCP capabilities, resources for learning core concepts, and prompts for guided tutorials.
Mcp Server Diff Python
Mcp
The registry mcp server updates your resume while you code
MCP to explore websites with llms.txt files
A Model Context Protocol (MCP) server that enables AI assistants to perform network scanning operations using NMAP
Model Context Protocol Server for Accessing twitter
An MCP server enhances AI responses with real-time search results via Higress ai-search.