Plane MCP Server

The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.

Remote serverstreamable-httpPython

What is the Plane MCP server?

Most monitoring and observability work still happens through a UI a human drives. Plane MCP server moves it into the conversation instead. The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.

The short version

A Model Context Protocol (MCP) server for Plane integration. This server provides tools and resources for interacting with Plane through AI agents.

  • 🔧 Plane Integration: Interact with Plane APIs and services
  • 🔌 Multiple Transports: Supports stdio, SSE, and streamable HTTP transports
  • 🌐 Remote & Local: Works both locally and as a remote service
  • 🛠️ Extensible: Easy to add new tools and resources

Getting it running

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

The tools it exposes

The server publishes 12 tools. What each one is for:

  • Authentication — The server requires authentication via environment variables:
  • Logging — The server emits structured JSON logs. Each tool call is logged with its tool name, duration, status, and (when available) the opaque user id and
  • Projects — The Projects tool exposed by this server
  • Cycles — The Cycles tool exposed by this server
  • Modules — The Modules tool exposed by this server
  • Initiatives — The Initiatives tool exposed by this server
  • Milestones — The Milestones tool exposed by this server
  • Labels — The Labels tool exposed by this server
  • States — The States tool exposed by this server
  • Pages — The Pages tool exposed by this server
  • Workspaces — The Workspaces tool exposed by this server
  • Users — The Users tool exposed by this server

What it needs from you

Configuration is passed through the environment: PLANE_API_KEY, PLANE_WORKSPACE_SLUG, PLANE_BASE_URL, PLANE_API_HOST_URL, PLANE_OAUTH_ALLOWED_REDIRECT_URIS, LOG_USER_INFO, PLANE_ACCESS_TOKEN, YOUR_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 12 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Plane.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Among the monitoring and observability options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Plane's toolset — Authentication, Logging, Projects and 9 more — is a fair guide to whether it matches your workflow.

This entry was verified against Plane's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
AuthenticationThe server requires authentication via environment variables:
LoggingThe server emits structured JSON logs. Each tool call is logged with its tool name, duration, status, and (when available) the opaque user id and workspace slug.
ProjectsThe Projects tool exposed by this server.
CyclesThe Cycles tool exposed by this server.
ModulesThe Modules tool exposed by this server.
InitiativesThe Initiatives tool exposed by this server.
MilestonesThe Milestones tool exposed by this server.
LabelsThe Labels tool exposed by this server.
StatesThe States tool exposed by this server.
PagesThe Pages tool exposed by this server.
WorkspacesThe Workspaces tool exposed by this server.
UsersThe Users tool exposed by this server.

How to install the Plane MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PLANE_API_KEYCredential the server authenticates with.Yes
PLANE_WORKSPACE_SLUGConfiguration value read at startup.Optional
PLANE_BASE_URLEndpoint or connection string the server talks to.Yes
PLANE_API_HOST_URLEndpoint or connection string the server talks to.Yes
PLANE_OAUTH_ALLOWED_REDIRECT_URISFilesystem location the server is allowed to use.Optional
LOG_USER_INFOConfiguration value read at startup.Optional
PLANE_ACCESS_TOKENCredential the server authenticates with.Yes
YOUR_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Plane to Authentication.
  • Use Plane to Logging.
  • Use Plane to Projects.

Frequently asked questions

It connects Plane to MCP-compatible AI assistants such as Claude and Cursor, exposing 12 tools (Authentication, Logging, Projects, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Plane directly.