Overview
What is MCP Planes Server?
MCP Planes Server is a Model Context Protocol (MCP) server that provides tools for interacting with Planes, a project and issue management tool. It allows listing and creating projects, issues, and labels through a standardized MCP interface.
How to use MCP Planes Server?
Clone the repository, install dependencies with npm install, copy .env.example to .env, and set your Planes API URL and API key. Run npm run dev for development or npm run build then npm start for production. Integrate with Claude by adding the provided mcpServers configuration to your Claude Desktop config.
Key features of MCP Planes Server
- List all accessible projects
- Get detailed information on a specific project
- List and create issues in a project
- Create new issues with relevant fields
- List and create labels in a project
Use cases of MCP Planes Server
- Automate project and issue management tasks from AI assistants
- Retrieve project details and issue status without opening the Planes UI
- Create new issues or labels programmatically through natural language prompts
- Integrate Planes data into LLM‑driven workflows
FAQ from MCP Planes Server
How do I authenticate with the Planes API?
Set your Planes API URL and API key in the .env file using the PLANES_API_URL and PLANES_API_KEY variables.
What tools does MCP Planes Server provide?
It provides tools for projects: list_projects and get_project; issues: list_issues, get_issue, and create_issue; and labels: list_labels and create_label.
How do I integrate MCP Planes Server with Claude?
Add the following configuration to your Claude Desktop config:
{
"mcpServers": {
"planes": {
"command": "npx",
"args": ["-y", "mcp-planes-server"],
"env": {
"PLANES_API_URL": "https://planes.inner.youdao.com/api",
"PLANES_API_KEY": "your_api_key_here"
}
}
}
}
What are the runtime requirements?
Node.js and npm are required. The README shows installation via Git, npm, and build/start commands.
