Plane MCP Server is an official Model Context Protocol implementation that enables AI agents and developer tools to programmatically interact with Plane workspaces. This server provides a seamless bridge to Plane's API, allowing users to create projects, manage issues, assign tasks, and synchronize work with AI-powered tools. It supports comprehensive project management operations including issue tracking, workflow management, team collaboration, and time logging. The server can be integrated with Claude Desktop and VSCode, requiring API key configuration for authentication. Licensed under MIT, it empowers developers to build intelligent assistants, automation scripts, and workflow-driven applications that naturally interact with Plane's project management ecosystem.
Get the current user's information from Plane workspace.
Retrieve all projects accessible to the current user in the Plane workspace.
Create a new project in the Plane workspace with specified name and configuration.
Get all issue types available for a specific project to understand workflow categorization.
Retrieve detailed information about a specific issue type including its properties and configuration.
Create a new issue type in a project with custom name and description for workflow management.
Modify an existing issue type's properties such as name, description, or other configuration fields.
Remove an issue type from a project when it's no longer needed in the workflow.
Get all available states for a specific project to understand the issue workflow progression.
Retrieve detailed information about a specific state including its properties and color coding.
Create a new state in a project with custom name and color for workflow management.
Modify an existing state's properties such as name, color, or other configuration fields.
Remove a state from a project when it's no longer needed in the workflow.
Get all labels available for a specific project for issue categorization and organization.
Retrieve detailed information about a specific label including its properties and color.
Create a new label in a project with custom name and color for issue categorization.
Modify an existing label's properties such as name, color, or other configuration fields.
Remove a label from a project when it's no longer needed for categorization.
Retrieve issue details using human-readable identifier format (e.g., PROJ-123) instead of UUID.
Get all comments associated with a specific issue for communication tracking.
Add a new comment to an issue with HTML content for team communication.
Create a new issue in a project with title, description, and other relevant properties.
Modify an existing issue's properties such as title, description, state, assignee, or labels.
Get all modules available in a specific project for feature organization and planning.
Retrieve detailed information about a specific module including its properties and associated issues.
Create a new module in a project for organizing related features or work items.
Modify an existing module's properties such as name, description, or timeline.
Remove a module from a project when it's no longer needed for organization.
Get all issues associated with a specific module for feature-based work tracking.
Associate multiple issues with a module for better feature organization and planning.
Remove an issue from a module when it's no longer part of that feature set.
Get all cycles available in a specific project for sprint-based development planning.
Retrieve detailed information about a specific cycle including timeline and associated issues.
Create a new cycle in a project with name, start date, and end date for sprint planning.
Modify an existing cycle's properties such as name, dates, or other configuration fields.
Remove a cycle from a project when it's no longer needed for sprint planning.
Get all issues associated with a specific cycle for sprint-based work tracking.
Associate multiple issues with a cycle for sprint planning and execution.
Remove an issue from a cycle when it's moved to a different sprint or backlog.
Retrieve all work logs associated with a specific issue for time tracking and reporting.
Get aggregated work log data for a project to analyze team productivity and time allocation.
Create a new work log entry for an issue with description and duration for time tracking.
Modify an existing work log entry's properties such as description, duration, or date.
Remove a work log entry when it's incorrectly recorded or no longer relevant.
{
"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>"
}
}
}
}