The Plane MCP Server enables AI agents and developer tools to interact programmatically with Plane workspaces. You can:
Create and manage projects directly from your AI or app interface
Update tasks programmatically (progress, assignments, properties, comments)
Move issues through workflows and update states dynamically
Organize work with labels, modules, and cycles
Analyze team data across projects
Build intelligent applications that interact seamlessly with Plane, such as AI agents logging work or bots maintaining project organization
Plane MCP Server
The Plane MCP Server brings the power of Model Context Protocol (MCP) to Plane, allowing AI agents and developer tools to interact programmatically with your Plane workspace.
Whether you're building intelligent assistants, automation scripts, or workflow-driven tools, this server provides a seamless bridge to Plane’s API—so you can create projects, manage issues, assign tasks, and keep your work in sync with AI-powered tools.
What can you do with it?
This server unlocks all sorts of useful capabilities for anyone working with Plane:
Spin up projects and work items directly from your AI or app interface.
Update progress, assign team members, set properties, or add comments—all programmatically.
Move issues through workflows and update their states on the fly.
Organize work with labels, modules, and cycles.
Analyze data about your team’s work across projects.
Build smart apps that interact naturally with Plane—whether it’s an AI agent logging work, or a bot keeping projects tidy.
Tools
Users
get_user
Get the current user's information
No parameters required
Projects
get_projects
Get all projects for the current user
No parameters required
create_project
Create a new project
Parameters:
name
(string, required): Project name
Issue Types
list_issue_types
Get all issue types for a specific project
Parameters:
project_id
(string, required): UUID of the project
get_issue_type
Get details of a specific issue type
Parameters:
project_id
(string, required): UUID of the projecttype_id
(string, required): UUID of the issue type
create_issue_type
Create a new issue type in a project
Parameters:
project_id
(string, required): UUID of the projectissue_type_data
: Object containing:name
(string, required): Name of the issue typedescription
(string, required): Description of the issue type
update_issue_type
Update an existing issue type
Parameters:
project_id
(string, required): UUID of the projecttype_id
(string, required): UUID of the issue typeissue_type_data
(object): Fields to update on the issue type
delete_issue_type
Delete an issue type
Parameters:
project_id
(string, required): UUID of the projecttype_id
(string, required): UUID of the issue type
States
list_states
Get all states for a specific project
Parameters:
project_id
(string, required): UUID of the project
get_state
Get details of a specific state
Parameters:
project_id
(string, required): UUID of the projectstate_id
(string, required): UUID of the state
create_state
Create a new state in a project
Parameters:
project_id
(string, required): UUID of the projectstate_data
: Object containing:name
(string, required): Name of the statecolor
(string, required): Color code for the state
update_state
Update an existing state
Parameters:
project_id
(string, required): UUID of the projectstate_id
(string, required): UUID of the statestate_data
(object): Fields to update on the state
delete_state
Delete a state
Parameters:
project_id
(string, required): UUID of the projectstate_id
(string, required): UUID of the state
Labels
list_labels
Get all labels for a specific project
Parameters:
project_id
(string, required): UUID of the project
get_label
Get details of a specific label
Parameters:
project_id
(string, required): UUID of the projectlabel_id
(string, required): UUID of the label
create_label
Create a new label in a project
Parameters:
project_id
(string, required): UUID of the projectlabel_data
: Object containing:name
(string, required): Name of the labelcolor
(string, required): Color code for the label
update_label
Update an existing label
Parameters:
project_id
(string, required): UUID of the projectlabel_id
(string, required): UUID of the labellabel_data
(object): Fields to update on the label
delete_label
Delete a label
Parameters:
project_id
(string, required): UUID of the projectlabel_id
(string, required): UUID of the label
Issues
get_issue_using_readable_identifier
Get issue details using readable identifier (e.g., PROJ-123)
Parameters:
project_identifier
(string, required)issue_identifier
(string, required): Issue numbe: Project identifier (e.g., "PROJ") r (e.g., "123")
get_issue_comments
Get all comments for a specific issue
Parameters:
project_id
(string, required): UUID of the projectissue_id
(string, required): UUID of the issue
add_issue_comment
Add a comment to an issue
Parameters:
project_id
(string, required): UUID of the projectissue_id
(string, required): UUID of the issuecomment_html
(string, required): HTML content of the comment
create_issue
Create a new issue
Parameters:
project_id
(string, required): UUID of the projectissue_data
: Object containing:name
(string, required): Title of the issuedescription_html
(string, required): HTML description of the issue
update_issue
Update an existing issue
Parameters:
project_id
(string, required): UUID of the projectissue_id
(string, required): UUID of the issueissue_data
(object): Fields to update on the issue
Modules
list_modules
Get all modules for a specific project
Parameters:
project_id
(string, required): UUID of the project
get_module
Get details of a specific module
Parameters:
project_id
(string, required): UUID of the projectmodule_id
(string, required): UUID of the module
create_module
Create a new module in a project
Parameters:
project_id
(string, required): UUID of the projectmodule_data
: Object containing:name
(string, required): Name of the module
update_module
Update an existing module
Parameters:
project_id
(string, required): UUID of the projectmodule_id
(string, required): UUID of the modulemodule_data
(object): Fields to update on the module
delete_module
Delete a module
Parameters:
project_id
(string, required): UUID of the projectmodule_id
(string, required): UUID of the module
Module Issues
list_module_issues
Get all issues for a specific module
Parameters:
project_id
(string, required): UUID of the projectmodule_id
(string, required): UUID of the module
add_module_issues
Add issues to a module
Parameters:
project_id
(string, required): UUID of the projectmodule_id
(string, required): UUID of the moduleissues
(string[], required): Array of issue UUIDs to add
delete_module_issue
Remove an issue from a module
Parameters:
project_id
(string, required): UUID of the projectmodule_id
(string, required): UUID of the moduleissue_id
(string, required): UUID of the issue to remove
Cycles
list_cycles
Get all cycles for a specific project
Parameters:
project_id
(string, required): UUID of the project
get_cycle
Get details of a specific cycle
Parameters:
project_id
(string, required): UUID of the projectcycle_id
(string, required): UUID of the cycle
create_cycle
Create a new cycle in a project
Parameters:
project_id
(string, required): UUID of the projectcycle_data
: Object containing:name
(string, required): Name of the cyclestart_date
(string, required): Start date (YYYY-MM-DD)end_date
(string, required) : End date (YYYY-MM-DD)
update_cycle
Update an existing cycle
Parameters:
project_id
(string, required): UUID of the projectcycle_id
(string, required): UUID of the cyclecycle_data
(object): Fields to update on the cycle
delete_cycle
Delete a cycle
Parameters:
project_id
(string, required): UUID of the projectcycle_id
(string, required): UUID of the cycle
Cycle Issues
list_cycle_issues
Get all issues for a specific cycle
Parameters:
project_id
(string, required): UUID of the projectcycle_id
(string, required): UUID of the cycle
add_cycle_issues
Add issues to a cycle
Parameters:
project_id
(string, required): UUID of the projectcycle_id
(string, required): UUID of the cycleissues
(string[], required): Array of issue UUIDs to add
delete_cycle_issue
Remove an issue from a cycle
Parameters:
project_id
(string, required): UUID of the projectcycle_id
(string, required): UUID of the cycleissue_id
(string, required): UUID of the issue to remove
Work Logs
get_issue_worklogs
Get all worklogs for a specific issue
Parameters:
project_id
(string, required): UUID of the projectissue_id
(string, required): UUID of the issue
get_total_worklogs
Get total logged time for a project
Parameters:
project_id
(string, required): UUID of the project
create_worklog
Create a new worklog for an issue
Parameters:
project_id
(string, required): UUID of the projectissue_id
(string, required): UUID of the issueworklog_data
: Object containing:description
(string, required): Description of the work doneduration
(integer, required): Duration in minutes
update_worklog
Update an existing worklog
Parameters:
project_id
(string, required): UUID of the projectissue_id
(string, required): UUID of the issueworklog_id
(string, required): UUID of the worklogworklog_data
(object): Fields to update on the worklog
delete_worklog
Delete a worklog
Parameters:
project_id
(string, required): UUID of the projectissue_id
(string, required): UUID of the issueworklog_id
(string, required): UUID of the worklog
Configuration Parameters
PLANE_API_KEY
- Your Plane API token. You can generate one from the Workspace Settings > API Tokens page (/settings/api-tokens/
) in the Plane app.PLANE_WORKSPACE_SLUG
- The workspace slug for your Plane instance. The workspace-slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL.PLANE_API_HOST_URL
(optional) - The host URL of the Plane API Server. Defaults to https://api.plane.so/
Usage
Claude Desktop
You can add Plane to Claude Desktop by updating your claude_desktop_config.json
:
VSCode
You can also connect Plane to VSCode by editing your .vscode.json
or mcp.json
file:
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol server that enables AI interfaces to seamlessly interact with Plane's project management system, allowing management of projects, issues, states, and other work items through a standardized API.
Related Resources
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.Last updated -73
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to interact with Plane.so, allowing them to manage projects and issues through Plane's API for streamlined project management workflows.Last updated -632MIT License
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -361
- AsecurityAlicenseAqualityA Model Context Protocol server providing AI assistants with comprehensive project, task, and subtask management capabilities with project-specific storage.Last updated -2933363MIT License