# plane-mcp

An MCP (Model Context Protocol) server for [Plane](https://plane.so) 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

```bash
pip install plane-mcp
```

Or from source:

```bash
git clone https://github.com/cmet7/plane-mcp.git
cd plane-mcp
pip install -e ".[dev]"
```

## Usage

### Stdio transport (for Claude Code)

```bash
PLANE_BASE_URL=https://plane.example.com PLANE_API_KEY=your_key python -m plane_mcp
```

### Claude Code configuration

```json
{
  "mcpServers": {
    "plane": {
      "command": "python3",
      "args": ["-m", "plane_mcp"],
      "env": {
        "PLANE_BASE_URL": "https://plane.example.com",
        "PLANE_API_KEY": "your_api_key"
      }
    }
  }
}
```

## Development

```bash
pip install -e ".[dev]"
pytest
ruff check src/ tests/
```

## License

MIT