plane-mcp
An MCP (Model Context Protocol) server for Plane project management.
Features
- Workspaces — list accessible workspaces
- Projects — list, get, and create projects
- Work Items — full CRUD for work items (issues)
- Cycles — manage cycles and assign work items
- Modules — manage modules and assign work items
- Labels — list and create labels
- States — list and create workflow states
- Members — list workspace members
Configuration
Set these environment variables:
| Variable | Description |
|---|---|
PLANE_BASE_URL | Your Plane instance URL (e.g. https://plane.example.com) |
PLANE_API_KEY | API key from Plane (Profile Settings > API Tokens) |
MCP_HOST | Host to bind HTTP transport (default: 0.0.0.0) |
MCP_PORT | Port for HTTP transport (default: 8080) |
Installation
pip install plane-mcp
Or from source:
git clone https://github.com/cmet7/plane-mcp.git
cd plane-mcp
pip install -e ".[dev]"
Usage
Stdio transport (for Claude Code)
PLANE_BASE_URL=https://plane.example.com PLANE_API_KEY=your_key python -m plane_mcp
Claude Code configuration
{
"mcpServers": {
"plane": {
"command": "python3",
"args": ["-m", "plane_mcp"],
"env": {
"PLANE_BASE_URL": "https://plane.example.com",
"PLANE_API_KEY": "your_api_key"
}
}
}
}
Development
pip install -e ".[dev]"
pytest
ruff check src/ tests/
License
MIT