Plane MCP Server Integration

What does “Plane” MCP Server do?

The Plane MCP Server is a Model Context Protocol (MCP) server that allows large language models (LLMs) to interact directly with Plane.so, a project and issue management platform. By acting as a bridge between AI assistants and the Plane.so API, this server lets LLMs perform project management actions such as listing projects, retrieving project details, creating and updating issues, and more—all while keeping user control and security in mind. This enhances the developer workflow by enabling AI-powered automation, data retrieval, and task management within the familiar Plane.so environment. LLMs like Claude can use Plane MCP Server to streamline project tracking, automate updates, and integrate conversational AI into project operations.

List of Prompts

No explicit prompt templates are described in the repository. This section is left empty due to lack of information.

List of Resources

No explicit MCP resources are documented in the repository. This section is left empty due to lack of information.

List of Tools

• list-projects
  • Lists all projects in your Plane workspace.
• get-project
  • Retrieves detailed information about a specific project (requires project_id).
• create-issue
  • Creates a new issue in a project with customizable properties.
• list-issues
  • Lists and filters issues from projects.
• get-issue
  • Gets detailed information about a specific issue.
• update-issue
  • Updates existing issues with new information.

Use Cases of this MCP Server

• Project Overview and Reporting
  • Instantly list all projects in a Plane workspace and retrieve project details, helping teams monitor ongoing work and project status.
• Automated Issue Creation
  • LLMs can create new issues in Plane.so, allowing for automated ticketing from conversations, bug reports, or user queries.
• Issue Tracking and Filtering
  • AI can list and filter issues by criteria, streamlining the process of triaging, prioritizing, and responding to project blockers.
• Issue Detail Retrieval
  • Developers or AI agents can quickly fetch issue details to inform workflow automation, code suggestions, or documentation.
• Project Management Automation
  • Routine updates and project changes can be handled by AI, reducing manual input and keeping project status up-to-date.

How to set it up

Windsurf

1. Ensure you have Node.js 22.x or higher and a Plane.so API key.
2. Install the server using Smithery:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client windsurf
   

3. Locate your Windsurf configuration file.
4. Add the Plane MCP server using the following JSON:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Save your changes and restart Windsurf.

Claude

1. Make sure Node.js 22.x or higher is installed along with a Plane.so API key.
2. Install via Smithery:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude
   

3. Open your Claude for Desktop config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Insert the following JSON under mcpServers:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Restart Claude for Desktop.

Cursor

1. Install Node.js 22.x+ and obtain your Plane.so API key.
2. Install with:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor
   

3. Edit your Cursor MCP configuration.
4. Add the following config:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Save and restart Cursor to apply changes.

Cline

1. Confirm Node.js 22.x+ is present and you have your Plane.so API key.
2. Run:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cline
   

3. Open your Cline MCP server configuration.
4. Add:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Save and restart Cline.

Securing API Keys:
Always store your PLANE_API_KEY and PLANE_WORKSPACE_SLUG as environment variables inside the env field of your configuration as shown above, never hard-code them in your source files.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "plane": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “plane” to the actual name of your MCP server and replace the URL with your own MCP server URL.

Overview

Our opinion:
Plane MCP Server provides excellent documentation for installation and tool usage, but lacks information on prompt templates, resource primitives, and sampling/roots support. The server is focused and practical for project management automation but would benefit from expanded MCP features and documentation. Overall, it’s well-suited for direct Plane.so integration.

MCP Score