Plane MCP Server

Features

• List all projects in your Plane workspace
• Get detailed information about specific projects
• Create new issues with customizable properties
• List and filter issues from projects
• Get detailed information about specific issues
• Update existing issues with new information

Prerequisites

• Node.js 22.x or higher
• A Plane.so API key
• A Plane.so workspace

Installation# Option 1: Using Smithery

The quickest way to get started is to use Smithery to install the server directly:

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

Option 2: Manual Setup

1. Clone this repository:

git clone https://github.com/kelvin6365/plane-mcp-server.git
cd plane-mcp-server

2. Install dependencies:

npm install

3. Build the server:

npm run build

Usage with Claude for Desktop

1. Open your Claude for Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the Plane MCP server configuration:

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

3. Restart Claude for Desktop

Available Tools

• list-projects: Lists all projects in your Plane workspace.
• get-project: Gets detailed information about a specific project.
• create-issue: Creates a new issue in a specified project.
• list-issues: Lists issues from a specified project with optional filtering.
• get-issue: Gets detailed information about a specific issue.
• update-issue: Updates an existing issue in a project.

Development

1. Install development dependencies:

npm install --save-dev typescript @types/node

2. Start the server in development mode:

npm run dev

License

This project is licensed under the MIT License - see the LICENSE file for details.