1
Add it to Claude Code
claude mcp add -e "PLANE_BASE_URL=${PLANE_BASE_URL}" -e "PLANE_API_KEY=${PLANE_API_KEY}" plane-mcp -- python3 -m plane_mcpRequired:
PLANE_BASE_URLPLANE_API_KEY+ 2 optional2
Make your agent remember this setup
plane-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Full CRUD operations for work items and issues
- Management of project cycles and modules
- Workspace member listing and project organization
- Workflow state and label management
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 transportTry 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.
Original README from cmet7/plane-mcp
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