The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.
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.
Interact with your Tmux sessions, windows and pane, execute commands in tmux panes and retrieve result.
MCP server for the incident management platform Rootly.
Connect your AI Agents to 8,000 apps instantly.
Interact with the accounting data in your business using our official MCP server
Miro MCP server, exposing all functionalities available in official Miro SDK.
A simple note storage system that allows adding and summarizing notes using a custom URI scheme.
Notion official MCP server
Programmatic control over Windows system operations including mouse, keyboard, window management, and screen capture using nut.js.
An MCP server for Cursor that enables requesting user input during generation process.
A CLI tool to synchronize MCP (Model Context Protocol) settings across multiple AI coding tools.