plane-mcp-server

Overview

This MCP server by Plane offers extensive tools for project management and collaboration. It supports multiple transport methods including stdio, SSE, and HTTP, making it compatible with various client environments. The server implements a comprehensive API covering projects, work items, cycles, modules, epics, milestones, labels, and more. It features strong authentication support through both API keys and OAuth tokens, with flexible configuration options for different use cases.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• list_projects

  List all projects in a workspace with optional pagination and filtering

  Try:Show me all projects in my workspaceTry:List active projects only
• create_project

  Create a new project with name, identifier, and optional configuration

  Try:Create a new project called 'Mobile App'Try:Set up a project for website redesign
• list_work_items

  List all work items in a project with optional filtering and pagination

  Try:Show me all tasks in the Mobile App projectTry:List high priority work items
• create_work_item

  Create a new work item with name, assignees, labels, and other attributes

  Try:Create a bug report for login issueTry:Add a new user story to the backlog
• retrieve_work_item

  Retrieve a work item by ID with optional field expansion

  Try:Get details for work item 123Try:Show me the full information for task XYZ
• update_work_item

  Update a work item with partial data

  Try:Mark task 123 as completedTry:Change priority of issue XYZ to high
• list_cycles

  List all cycles in a project

  Try:Show me all current cyclesTry:List upcoming development cycles
• create_cycle

  Create a new cycle with name, dates, and owner

  Try:Create a new sprint for the next two weeksTry:Set up a Q1 planning cycle
• retrieve_project

  Retrieve a project by ID

  Try:Get details for project 456Try:Show me the mobile app project information
• delete_work_item

  Delete a work item by ID

  Try:Remove obsolete task 789Try:Delete closed issue XYZ
• list_epics

  List all epics in a project

  Try:Show me all epics in the projectTry:List high-level epics for planning
• create_epic

  Create a new epic

  Try:Create a new epic for user authenticationTry:Add an epic for payment processing

Comparable tools

Installation

uvx plane-mcp-server stdio

npx mcp-remote@latest https://mcp.plane.so/http/mcp

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

FAQ

What authentication methods are supported?

The server supports both API key authentication (for stdio transport) and OAuth (for remote transports). You can also use Personal Access Tokens (PAT) for remote connections.

Which transport method should I use?

Stdio transport is recommended for local use as it doesn't require installation. For remote connections, HTTP transport is preferred over the legacy SSE transport.

What data can I access through the MCP server?

The server provides tools for accessing and managing projects, work items, cycles, modules, epics, milestones, labels, states, and comments.

Compare plane-mcp-server with