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_userGet the current user's information
No parameters required
Projects
get_projectsGet all projects for the current user
No parameters required
create_projectCreate a new project
Parameters:
name(string, required): Project name
Issue Types
list_issue_typesGet all issue types for a specific project
Parameters:
project_id(string, required): UUID of the project
get_issue_typeGet 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_typeCreate 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_typeUpdate 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_typeDelete an issue type
Parameters:
project_id(string, required): UUID of the projecttype_id(string, required): UUID of the issue type
States
list_statesGet all states for a specific project
Parameters:
project_id(string, required): UUID of the project
get_stateGet details of a specific state
Parameters:
project_id(string, required): UUID of the projectstate_id(string, required): UUID of the state
create_stateCreate 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_stateUpdate 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_stateDelete a state
Parameters:
project_id(string, required): UUID of the projectstate_id(string, required): UUID of the state
Labels
list_labelsGet all labels for a specific project
Parameters:
project_id(string, required): UUID of the project
get_labelGet details of a specific label
Parameters:
project_id(string, required): UUID of the projectlabel_id(string, required): UUID of the label
create_labelCreate 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_labelUpdate 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_labelDelete a label
Parameters:
project_id(string, required): UUID of the projectlabel_id(string, required): UUID of the label
Issues
get_issue_using_readable_identifierGet 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_commentsGet all comments for a specific issue
Parameters:
project_id(string, required): UUID of the projectissue_id(string, required): UUID of the issue
add_issue_commentAdd 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_issueCreate 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_issueUpdate 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_modulesGet all modules for a specific project
Parameters:
project_id(string, required): UUID of the project
get_moduleGet details of a specific module
Parameters:
project_id(string, required): UUID of the projectmodule_id(string, required): UUID of the module
create_moduleCreate 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_moduleUpdate 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_moduleDelete a module
Parameters:
project_id(string, required): UUID of the projectmodule_id(string, required): UUID of the module
Module Issues
list_module_issuesGet all issues for a specific module
Parameters:
project_id(string, required): UUID of the projectmodule_id(string, required): UUID of the module
add_module_issuesAdd 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_issueRemove 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_cyclesGet all cycles for a specific project
Parameters:
project_id(string, required): UUID of the project
get_cycleGet details of a specific cycle
Parameters:
project_id(string, required): UUID of the projectcycle_id(string, required): UUID of the cycle
create_cycleCreate 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_cycleUpdate 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_cycleDelete a cycle
Parameters:
project_id(string, required): UUID of the projectcycle_id(string, required): UUID of the cycle
Cycle Issues
list_cycle_issuesGet all issues for a specific cycle
Parameters:
project_id(string, required): UUID of the projectcycle_id(string, required): UUID of the cycle
add_cycle_issuesAdd 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_issueRemove 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_worklogsGet all worklogs for a specific issue
Parameters:
project_id(string, required): UUID of the projectissue_id(string, required): UUID of the issue
get_total_worklogsGet total logged time for a project
Parameters:
project_id(string, required): UUID of the project
create_worklogCreate 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_worklogUpdate 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_worklogDelete 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