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