MCP Planes Server
A Model Context Protocol (MCP) server for interacting with Planes - Project and issue management tool.
Features
- Project management
- List all projects
- Get project details
- Issue tracking
- List issues
- Get issue details
- Create new issues
- Label management
- List labels
- Create new labels
Installation
# Clone the repository
git clone https://github.com/yourusername/mcp-planes-server.git
# Install dependencies
cd mcp-planes-server
npm install
# Copy environment variables
cp .env.example .env
Configuration
Edit the .env
file and set your Planes API credentials:
PLANES_API_URL=https://planes.inner.youdao.com/api
PLANES_API_KEY=your_api_key_here
Usage
Development
npm run dev
Production
npm run build
npm start
Integration 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"
}
}
}
}
Available Tools
Project Tools
list_projects
: List all accessible projectsget_project
: Get details of a specific project
Issue Tools
list_issues
: List all issues in a projectget_issue
: Get details of a specific issuecreate_issue
: Create a new issue in a project
Label Tools
list_labels
: List all labels in a projectcreate_label
: Create a new label in a project
License
MIT