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:

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