Plane

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