Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Project management - official Plane server

Plane MCP server

Open-source MCP server for Plane, available hosted at mcp.plane.so or run locally with uvx; exposes 30 resource tools covering 207 actions across work items, cycles, modules, releases, pages, templates, customers and more. Plane hosts it at https://mcp.plane.so/http/mcp, or you can run plane-mcp-server (pypi) locally with OAuth or API key auth.

Last verified 15 tools6 sources

Install

Claude Code

About Claude Code
Terminal
claude mcp add --transport http plane https://mcp.plane.so/http/mcp
# In a session, run /mcp and authenticate (or run: claude mcp login plane).
claude mcp list

Codex

About Codex
Terminal
codex mcp add plane --url https://mcp.plane.so/http/mcp
codex mcp login plane
codex mcp list

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "plane": {
      "url": "https://mcp.plane.so/http/mcp"
    }
  }
}

VS Code

Snippet
code --add-mcp '{"name":"plane","type":"http","url":"https://mcp.plane.so/http/mcp"}'

Generic

JSON
{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<your-api-key>",
        "PLANE_WORKSPACE_SLUG": "<your-workspace-slug>"
      }
    }
  }
}

Tools

workitem
Create, update, list, count and search work items; list and count accept PQL filters.
workitem_comment
Comment on work items.
workitem_attachment
Attach files to work items, including upload from URL.
workitem_link
Manage links on work items.
workitem_relation
Relate work items to each other.
work_log
Log time against work items.
cycle
Plan cycles, archive them and transfer work items between cycles.
module
Plan modules and list their work items.
milestone
Manage milestones.
initiative
Manage initiatives.
release
Manage releases, their work items and changelogs.
project
Manage projects (paginated list).
page
Manage pages.
customer
Manage customers and linked work.
get_pql_reference
Return the Plane Query Language reference before composing filters.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Endpoints: https://mcp.plane.so/http/mcp (OAuth, recommended), https://mcp.plane.so/http/api-key/mcp (personal access token via Authorization: Bearer plus x-workspace-slug headers), uvx plane-mcp-server stdio (env vars, Python 3.10+), and https://mcp.plane.so/sse (deprecated).
  • The hosted service cannot reach private self-hosted Plane instances; use stdio with PLANE_BASE_URL or self-host the server.
  • The OAuth transport needs Plane OAuth app registration, available on Plane Cloud and Commercial Edition only.
  • The old Node.js package @makeplane/plane-mcp-server is deprecated. v0.3.0 consolidated 177 per-operation tools into resource tools; 169 old names still resolve as hidden aliases.
  • Plan-gated actions return a message naming the feature.
  • Latest release v0.3.4 (GitHub 2026-10-08, PyPI 2026-10-09).
  • The vendor does not use a beta or GA label; ga reflects production hosted docs.
  • The official registry hint for this vendor (io.github.planetscale/mcp-server) belongs to PlanetScale, not Plane, and should be ignored.

More MCP servers for project management

Related reading

FAQ

What does the Plane MCP server do?

Open-source MCP server for Plane, available hosted at mcp.plane.so or run locally with uvx; exposes 30 resource tools covering 207 actions across work items, cycles, modules, releases, pages, templates, customers and more. The vendor documents 15 tools, including workitem, workitem_comment, workitem_attachment and workitem_link.

How do I add the Plane MCP server to Claude Code?

Plane documents a Claude Code config; copy it from the Claude Code section of this page. Snippets for Codex, Cursor, VS Code and Generic are there too.

Does the Plane MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP, stdio, SSE. Status: GA, last checked October 17, 2026.

Sources

Last verified against 6 Plane pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.