Plane Mcp Server MCP Server

A Model Context Protocol (MCP) server that enables LLMs to interact with Plane.so, allowing them to manage projects and issues through Plane's API. Using this server, LLMs like Claude can directly…

Local serverstdioMIT

What is the Plane Mcp Server?

Plane Mcp Server is an MCP project maintained in the disrex-group/plane-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that enables LLMs to interact with Plane.so, allowing them to manage projects and issues through Plane's API. Using this…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @disrex/plane-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares PLANE_API_KEY, PLANE_WORKSPACE_SLUG. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
per_pageoptional): Number of items per page (default: 100, max: 100)
cursoroptional): Pagination cursor in format 'value:offset:is_prev'
project_idID of the project
description_htmlHTML description of the sub-issue (optional)
priorityPriority of the sub-issue (urgent, high, medium, low, none) (optional)
state_idID of the state for this sub-issue (optional)
assigneesArray of user IDs to assign to this sub-issue (optional)
labelsoptional): Updated array of label IDs to assign to this issue
assignee_idoptional): Filter by assignee ID
issue_idID of the sub-issue to convert to regular issue
groupoptional): Updated state group
coloroptional): Updated color code for the label (e.g., "ff0000")
module_idID of the module to remove issue from
start_dateoptional): Updated start date of the cycle (YYYY-MM-DD format)
target_dateoptional): Updated target end date of the module
statusoptional): Updated status of the module
leadoptional): Updated user ID of the module lead
membersoptional): Updated array of user IDs for module members
issuesArray of issue IDs to add to the cycle
cycle_idID of the source cycle to transfer issues from
owned_byID of the user who will own this cycle
end_dateoptional): Updated end date of the cycle (YYYY-MM-DD format)
label_idID of the label to delete
comment_idID of the comment to delete
commentThe updated comment text
link_idID of the link to delete
titleoptional): Updated title/name for the link
urloptional): Updated URL
file_nameName of the file to upload
file_sizeSize of the file in bytes
content_typeMIME type of the file (e.g., 'image/png', 'application/pdf')
activity_idID of the activity to retrieve
durationoptional): Updated time logged in hours
worklog_idID of the worklog to delete
type_idID of the issue type
property_idID of the property
display_nameDisplay name for the property (optional)
property_typeType of property (TEXT, NUMBER, DATE, OPTION, MULTI_OPTION, BOOLEAN)
is_requiredWhether this property is required (optional)
is_multiWhether multiple values are allowed (optional)
sort_orderSort order for the option (optional)
is_defaultWhether this is the default option (optional)
option_idID of the option to update
parent_issue_idID of the parent issue
new_cycle_idID of the target cycle to transfer issues to

How to install the Plane Mcp Server

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": [
        "-y",
        "@disrex/plane-mcp-server"
      ],
      "env": {
        "PLANE_API_KEY": "YOUR_PLANE_API_KEY",
        "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PLANE_API_KEYDeclared in the maintainer’s client configuration.Check documentation
PLANE_WORKSPACE_SLUGDeclared in the maintainer’s client configuration.Check documentation