モデルコンテキストプロトコルサーバー Plane。AIエージェントにプロジェクトを読み管理するためのツールを提供します。 作業項目、サイクル、モジュール、リリース、顧客など。

FastMCPおよび公式の plane-sdk。

• 30のツール、各平面リソースにつき1つ、207の操作をカバー
• ローカルまたはリモート — stdio、ストリーミング可能なHTTP、SSE
• OAuthまたはAPIキー認証

クイックスタート

PlaneからAPIキーを取得してください:Workspace Settings → API tokens。

これをMCPクライアントの設定に追加してください:

[uvxはインストールステップを必要としません。Python 3.10+が必要です。

セルフホスト型の平面の場合は、"PLANE_BASE_URL": "https://plane.example.com"を追加してください。

輸送機

Stdio — ローカル

MCPクライアントのサブプロセスとして動作します。上記の構成;ニーズ PLANE_API_KEYおよびPLANE_WORKSPACE_SLUG。

OAuth でのHTTPはホストされています

https://mcp.plane.so/http/mcp

OAuthフローはConnect上で処理されます。設定には認証情報はありません。クライアント向け ネイティブリモートMCPサポートがない場合、mcp-remoteとのブリッジ:

Node.js 22+が必要です。

パーソナルアクセストークンを持つHTTP — ホスト

https://mcp.plane.so/http/api-key/mcp

Plane MCP Server

A Model Context Protocol server for Plane. Gives an AI agent tools to read and manage projects, work items, cycles, modules, releases, customers and more.

Built on FastMCP and the official plane-sdk.

• 30 tools, one per Plane resource, covering 207 operations
• Local or remote — stdio, streamable HTTP, SSE
• OAuth or API key authentication

Quick start

Get an API key from Plane: Workspace Settings → API tokens.

Add this to your MCP client’s configuration:

{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "",
        "PLANE_WORKSPACE_SLUG": ""
      }
    }
  }
}

uvx needs no install step. Requires Python 3.10+.

For a self-hosted Plane, add "PLANE_BASE_URL": "https://plane.example.com".

Transports

stdio — local

Runs as a subprocess of your MCP client. Configuration as shown above; needs PLANE_API_KEY and PLANE_WORKSPACE_SLUG.

PLANE_API_KEY=... PLANE_WORKSPACE_SLUG=... uvx plane-mcp-server stdio

HTTP with OAuth — hosted

https://mcp.plane.so/http/mcp

The OAuth flow is handled on connect; no credentials in your config. For clients without native remote MCP support, bridge with mcp-remote:

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/mcp"]
    }
  }
}

Requires Node.js 22+.

HTTP with a personal access token — hosted

https://mcp.plane.so/http/api-key/mcp

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/api-key/mcp"],
      "headers": {
        "Authorization": "Bearer ",
        "X-Workspace-slug": ""
      }
    }
  }
}

SSE — deprecated

https://mcp.plane.so/sse is maintained for backward compatibility only. Use an HTTP transport instead.

Tools

The server advertises 30 tools, one per resource. Each takes an action parameter that selects the operation:

workitem(action="create", project_id=..., name="Fix login")
workitem(action="list", project_id=..., pql='state__group = "started"')
cycle(action="archive", project_id=..., cycle_id=...)

Every tool’s description lists its actions with their required and optional parameters, so the catalogue is self-documenting at call time.

→ Full tool and action reference

Querying work items

List, count and search accept PQL, Plane’s query language:

workitem(action="list", project_id=..., pql='state__group = "started" AND priority = "urgent"')