Plane

A Model Context Protocol (MCP) server that enables LLMs to interact withPlane.so, allowing them to manage projects and issues through Plane's API. Using this server, LLMs like Claude can directly interact with your project management workflows while maintaining user control and security.

# Install to Claude for Desktop npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude

npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor

git clone https://github.com/kelvin6365/plane-mcp-server.git cd plane-mcp-server

{ "mcpServers": { "plane": { "command": "node", "args": ["path/to/plane-mcp-server/build/index.js"], "env": { "PLANE_API_KEY": "your_plane_api_key_here", "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here", "PLANE_HOST": "optional" } } } }

Note:Tool names use hyphens (e.g.,list-projects), not underscores. The server will automatically convert underscores to hyphens for compatibility.

Lists all projects in your Plane workspace.

Gets detailed information about a specific project.

- project_id: ID of the project to retrieve

{ "project_id": "01abc123-4567-89de-0123-456789abcdef" }

Creates a new issue in a specified project.

- project_id: ID of the project where the issue should be created
- name: Title of the issue
- description_html: HTML description of the issue (required by Plane API)
- priority(optional): Priority of the issue ("urgent", "high", "medium", "low", "none")
- state_id(optional): ID of the state for this issue
- assignees(optional): Array of user IDs to assign to this issue

Note:Theassigneesparameter must be an array of user ID strings. Common errors include providing a dictionary/object instead of an array, or accidentally nesting the entire issue data inside the assignees field. The server will attempt to handle these cases, but it's best to use the correct format.

{ "project_id": "01abc123-4567-89de-0123-456789abcdef", "name": "Implement new feature", "description_html": "<p>We need to implement the new reporting feature</p>", "priority": "high", "assignees": ["user-id-1", "user-id-2"] }

Lists issues from a specified project with optional filtering.

- project_id: ID of the project to get issues from
- state_id(optional): Filter by state ID
- priority(optional): Filter by priority
- assignee_id(optional): Filter by assignee ID
- limit(optional): Maximum number of issues to return (default: 50)

{ "project_id": "01abc123-4567-89de-0123-456789abcdef", "priority": "high", "limit": 10 }

Gets detailed information about a specific issue.

- project_id: ID of the project containing the issue
- issue_id: ID of the issue to retrieve

{ "project_id": "01abc123-4567-89de-0123-456789abcdef", "issue_id": "01def456-7890-12gh-3456-789ijklmnopq" }

- project_id: ID of the project containing the issue
- issue_id: ID of the issue to update
- name(optional): Updated title of the issue
- description_html(optional): HTML description of the issue (required by Plane API)
- priority(optional): Updated priority of the issue
- state_id(optional): Updated state ID of the issue
- assignees(optional): Updated array of user IDs to assign to this issue

Note:Theassigneesparameter must be an array of user ID strings, following the same format guidelines as the create-issue tool.

{ "project_id": "01abc123-4567-89de-0123-456789abcdef", "issue_id": "01def456-7890-12gh-3456-789ijklmnopq", "priority": "urgent", "description_html": "<p>Updated description with <strong>more details</strong></p>" }

npm install --save-dev typescript @types/node

You can test the server using the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Here are some example interactions you can try with Claude after setting up the Plane MCP server:
- "Can you list all the projects in my Plane workspace?"
- "Please create a new high-priority issue in the Marketing project titled 'Update social media strategy'"
- "What are all the high-priority issues in the Development project?"
- "Update issue #123 in the QA project to change its priority to urgent"

Claude will use the appropriate tools to interact with Plane while asking for your approval before creating or modifying any issues.

- The API key requires proper Plane permissions to function
- All operations that modify data require explicit user approval
- Environment variables should be properly secured
- API keys should never be committed to version control
- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

If you encounter any issues or have questions:
- Check the GitHub Issues section
- Consult the MCP documentation atmodelcontextprotocol.io
- Open a new issue with detailed reproduction steps

Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem