README.md
An MCP server for the Plane project management platform
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
Tools (8)
workspacesList accessible workspaces in the Plane instance.projectsList, get, and create projects within a workspace.work_itemsPerform full CRUD operations for work items or issues.cyclesManage project cycles and assign work items to them.modulesManage project modules and assign work items to them.labelsList and create labels for organizing work items.statesList and create workflow states for project tracking.membersList all members associated with a workspace.Environment Variables
PLANE_BASE_URLrequiredYour Plane instance URLPLANE_API_KEYrequiredAPI key from Plane Profile SettingsMCP_HOSTHost to bind HTTP transportMCP_PORTPort for HTTP transportConfiguration
claude_desktop_config.json
{"mcpServers": {"plane": {"command": "python3", "args": ["-m", "plane_mcp"], "env": {"PLANE_BASE_URL": "https://plane.example.com", "PLANE_API_KEY": "your_api_key"}}}}Try it
→List all the active projects in my workspace.
→Create a new issue in the 'Engineering' project titled 'Fix login bug' with high priority.
→Show me all work items currently assigned to the current cycle.
→List all members in my workspace and their roles.
→Create a new label called 'Documentation' for the current project.