# Plane MCP server

> Lets an AI client read and manage Plane projects, work items, cycles, modules, releases, and customers via 30 tools.

- Repository: https://github.com/makeplane/plane-mcp-server
- Page: https://hostedmcp.org/servers/makeplane/plane-mcp-server
- Official: yes
- Transport: —
- Stars: 364
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `LOG_PAYLOADS` | no | no |  |
| `LOG_USER_INFO` | no | no |  |
| `PLANE_API_KEY` | no | no |  |
| `PLANE_BASE_URL` | no | no |  |
| `PLANE_OAUTH_ALLOWED_REDIRECT_URIS` | no | no |  |
| `PLANE_TEST_API_KEY` | no | no |  |
| `PLANE_TEST_MCP_URL` | no | no |  |
| `PLANE_WORKSPACE_SLUG` | no | no |  |

## FAQ

### How do I connect the Plane MCP server with an API key?

Run the server locally over stdio with uvx and set PLANE_API_KEY and PLANE_WORKSPACE_SLUG in your MCP client's env config. Python 3.10+ is required.

### Can I filter work items with a query language?

Yes, list, count and search accept PQL, Plane's query language, and you can call get_pql_reference for full syntax and examples.

### How many tools does the Plane MCP server expose?

It advertises 30 tools, one per Plane resource, each with an action parameter covering 207 operations in total.

### Can I use a self-hosted Plane instance?

Yes, set PLANE_BASE_URL to your instance's API URL when running over stdio.