What can you do with this server?

The Plane MCP Server enables AI agents and developer tools to interact programmatically with Plane workspaces. You can: * Create and manage projects directly from your AI or app interface * Update tasks programmatically (progress, assignments, properties, comments) * Move issues through workflows and update states dynamically * Organize work with labels, modules, and cycles * Analyze team data across projects * Build intelligent applications that interact seamlessly with Plane, such as AI agents logging work or bots maintaining project organization

How do I use Plane MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Plane MCP Server list all open issues in the marketing project" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

Plane MCP Server

Official

by makeplane

Overview Schema Related Servers Score Discussions

Python

Remote

Plane MCP Server

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

Features

🔧 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

Related MCP server: Plane MCP Server

Usage

The server supports three transport methods. We recommend using uvx as it doesn't require installation.

Requirements:

Python 3.10+ (for stdio transport, via uvx)
Node.js 22+ (for remote transports, via npx)

1. Stdio Transport (for local use)

MCP Client Configuration (using uvx - recommended):

{
  "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"
      }
    }
  }
}

2. Remote HTTP Transport with OAuth

Connect to the hosted Plane MCP server using OAuth authentication.

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

MCP Client Configuration (for tools like Claude Desktop without native remote MCP support):

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

Note: OAuth authentication will be handled automatically when connecting to the remote server.

3. Remote HTTP Transport using PAT Token

Connect to the hosted Plane MCP server using a Personal Access Token (PAT).

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

Headers:

Authorization: Bearer <PAT_TOKEN>
X-Workspace-slug: <SLUG>

MCP Client Configuration (for tools like Claude Desktop without native remote MCP support):

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

4. SSE Transport (Legacy)

⚠️ Legacy Transport: SSE (Server-Sent Events) transport is maintained for backward compatibility. New implementations should use the HTTP transport (sections 2 or 3) instead.

Connect to the hosted Plane MCP server using OAuth authentication via Server-Sent Events.

URL: https://mcp.plane.so/sse

MCP Client Configuration (for tools that support SSE transport):

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

Note: OAuth authentication will be handled automatically when connecting to the remote server. This transport is deprecated in favor of the HTTP transport.

Configuration

Authentication

The server requires authentication via environment variables:

PLANE_BASE_URL: Base URL for Plane API (default: https://api.plane.so) - Optional
PLANE_API_KEY: API key for authentication (required for stdio transport)
PLANE_WORKSPACE_SLUG: Workspace slug identifier (required for stdio transport)
PLANE_ACCESS_TOKEN: Access token for authentication (alternative to API key)

Example (for stdio transport):

export PLANE_BASE_URL="https://api.plane.so"
export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE_SLUG="your-workspace-slug"

Note: For remote HTTP transports (OAuth or PAT), authentication is handled via the connection method (OAuth flow or PAT headers) and does not require these environment variables.

Available Tools

The server provides comprehensive tools for interacting with Plane. All tools use Pydantic models from the Plane SDK for type safety and validation.

Projects

Tool Name	Description
`list_projects`	List all projects in a workspace with optional pagination and filtering
`create_project`	Create a new project with name, identifier, and optional configuration
`retrieve_project`	Retrieve a project by ID
`update_project`	Update a project with partial data
`delete_project`	Delete a project by ID
`get_project_worklog_summary`	Get work log summary for a project
`get_project_members`	Get all members of a project
`get_project_features`	Get features configuration of a project
`update_project_features`	Update features configuration of a project

Work Items

Tool Name	Description
`list_work_items`	List all work items in a project with optional filtering and pagination
`create_work_item`	Create a new work item with name, assignees, labels, and other attributes
`retrieve_work_item`	Retrieve a work item by ID with optional field expansion
`retrieve_work_item_by_identifier`	Retrieve a work item by project identifier and issue sequence number
`update_work_item`	Update a work item with partial data
`delete_work_item`	Delete a work item by ID
`search_work_items`	Search work items across a workspace with query string

Cycles

Tool Name	Description
`list_cycles`	List all cycles in a project
`create_cycle`	Create a new cycle with name, dates, and owner
`retrieve_cycle`	Retrieve a cycle by ID
`update_cycle`	Update a cycle with partial data
`delete_cycle`	Delete a cycle by ID
`list_archived_cycles`	List archived cycles in a project
`add_work_items_to_cycle`	Add work items to a cycle
`remove_work_item_from_cycle`	Remove a work item from a cycle
`list_cycle_work_items`	List work items in a cycle
`transfer_cycle_work_items`	Transfer work items from one cycle to another
`archive_cycle`	Archive a cycle
`unarchive_cycle`	Unarchive a cycle

Modules

Tool Name	Description
`list_modules`	List all modules in a project
`create_module`	Create a new module with name, dates, status, and members
`retrieve_module`	Retrieve a module by ID
`update_module`	Update a module with partial data
`delete_module`	Delete a module by ID
`list_archived_modules`	List archived modules in a project
`add_work_items_to_module`	Add work items to a module
`remove_work_item_from_module`	Remove a work item from a module
`list_module_work_items`	List work items in a module
`archive_module`	Archive a module
`unarchive_module`	Unarchive a module

Initiatives

Tool Name	Description
`list_initiatives`	List all initiatives in a workspace
`create_initiative`	Create a new initiative with name, dates, state, and lead
`retrieve_initiative`	Retrieve an initiative by ID
`update_initiative`	Update an initiative with partial data
`delete_initiative`	Delete an initiative by ID

Intake Work Items

Tool Name	Description
`list_intake_work_items`	List all intake work items in a project with optional pagination
`create_intake_work_item`	Create a new intake work item in a project
`retrieve_intake_work_item`	Retrieve an intake work item by work item ID with optional field expansion
`update_intake_work_item`	Update an intake work item with partial data
`delete_intake_work_item`	Delete an intake work item by work item ID

Work Item Properties

Tool Name	Description
`list_work_item_properties`	List work item properties for a work item type
`create_work_item_property`	Create a new work item property with type, settings, and validation rules
`retrieve_work_item_property`	Retrieve a work item property by ID
`update_work_item_property`	Update a work item property with partial data
`delete_work_item_property`	Delete a work item property by ID

Epics

Tool Name	Description
`list_epics`	List all epics in a project
`create_epic`	Create a new epic
`retrieve_epic`	Retrieve an epic by ID
`update_epic`	Update an epic by ID
`delete_epic`	Delete an epic by ID

Milestones

Tool Name	Description
`list_milestones`	List all milestones in a project
`create_milestone`	Create a new milestone
`retrieve_milestone`	Retrieve a milestone by ID
`update_milestone`	Update a milestone by ID
`delete_milestone`	Delete a milestone by ID
`add_work_items_to_milestone`	Add work items to a milestone
`remove_work_items_from_milestone`	Remove work items from a milestone
`list_milestone_work_items`	List work items in a milestone

Labels

Tool Name	Description
`list_labels`	List all labels in a project
`create_label`	Create a new label
`retrieve_label`	Retrieve a label by ID
`update_label`	Update a label by ID
`delete_label`	Delete a label by ID

States

Tool Name	Description
`list_states`	List all states in a project
`create_state`	Create a new state
`retrieve_state`	Retrieve a state by ID
`update_state`	Update a state by ID
`delete_state`	Delete a state by ID

Work Item Comments

Tool Name	Description
`list_work_item_comments`	List comments for a work item
`retrieve_work_item_comment`	Retrieve a specific comment for a work item
`create_work_item_comment`	Create a comment for a work item
`update_work_item_comment`	Update a comment for a work item
`delete_work_item_comment`	Delete a comment for a work item

Work Item Links

Tool Name	Description
`list_work_item_links`	List links for a work item
`retrieve_work_item_link`	Retrieve a specific link for a work item
`create_work_item_link`	Create a link for a work item
`update_work_item_link`	Update a link for a work item
`delete_work_item_link`	Delete a link for a work item

Work Item Types

Tool Name	Description
`list_work_item_types`	List all work item types in a project
`create_work_item_type`	Create a new work item type
`retrieve_work_item_type`	Retrieve a work item type by ID
`update_work_item_type`	Update a work item type by ID
`delete_work_item_type`	Delete a work item type by ID

Work Item Relations

Tool Name	Description
`list_work_item_relations`	List relations for a work item
`create_work_item_relation`	Create relations for a work item
`remove_work_item_relation`	Remove a relation from a work item

Work Item Activities

Tool Name	Description
`list_work_item_activities`	List activities for a work item
`retrieve_work_item_activity`	Retrieve a specific activity for a work item

Work Logs

Tool Name	Description
`list_work_logs`	List work logs for a work item
`create_work_log`	Create a work log for a work item
`update_work_log`	Update a work log for a work item
`delete_work_log`	Delete a work log for a work item

Pages

Tool Name	Description
`retrieve_workspace_page`	Retrieve a workspace page by ID
`retrieve_project_page`	Retrieve a project page by ID
`create_workspace_page`	Create a workspace page
`create_project_page`	Create a project page

Workspaces

Tool Name	Description
`get_workspace_members`	Get all members of the current workspace
`get_workspace_features`	Get features of the current workspace
`update_workspace_features`	Update features of the current workspace

Users

Tool Name	Description
`get_me`	Get current authenticated user information

Total Tools: 100+ tools across 20 categories

Development

Running Tests

pytest

Code Formatting

black plane_mcp/
ruff check plane_mcp/

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Deprecation Notice

⚠️ The Node.js-based plane-mcp-server is deprecated and no longer maintained.

This repository represents the new Python+FastMCP based implementation of the Plane MCP server. If you were using the previous Node.js version, please migrate to this Python-based version for continued support and updates.

The new implementation offers:

Better type safety with Pydantic models
Improved performance with FastMCP
Enhanced tool coverage
Active maintenance and development

For migration assistance, please refer to the configuration examples in this README or open an issue for support.

Old Node.js Configuration (Deprecated):

If you were using the previous Node.js-based @makeplane/plane-mcp-server, your configuration looked like this:

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": [
        "-y",
        "@makeplane/plane-mcp-server"
      ],
      "env": {
        "PLANE_API_KEY": "<YOUR_API_KEY>",
        "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED>",
        "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
      }
    }
  }
}

Please migrate to the new Python-based configuration shown in the Usage section above.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

56dResponse time

2wRelease cycle

13Releases (12mo)

Issues opened vs closed

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/makeplane/plane-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server