Plane MCP

How to Install and Use Plane MCP

If you want to connect your AI tools or apps to Plane easily and manage your projects, tasks, and issues programmatically, Plane MCP is the right server for you. It lets you communicate with Plane's API smoothly. Here’s a simple guide on how to install and start using Plane MCP step-by-step.

Step 1: Get Your API Key and Workspace Slug

Before you install Plane MCP, you need two important things:

• Your Plane API key, which you can generate inside the Plane app under Workspace Settings > API Tokens.
• Your workspace slug, which is the unique name for your workspace. You can find it in your Plane URL.

Keep these ready because you will need them in the next steps.

Step 2: Set Up the Environment Variables

Plane MCP requires a few environment settings to work properly. These tell it how to connect to your Plane workspace.

The key environment variables are:

PLANE_API_KEY=<Your API Key>
PLANE_WORKSPACE_SLUG=<Your Workspace Slug>
PLANE_API_HOST_URL=https://api.plane.so  # This is optional and only needed if self-hosting

Replace <Your API Key> and <Your Workspace Slug> with the real values you got before.

Step 3: Install Plane MCP Using npm

Plane MCP runs as an npm package. You don’t need to download or configure anything manually if you have Node.js installed.

Open your terminal or command prompt and run this command to install and use the server on the fly:

npx -y @makeplane/plane-mcp-server

This starts the Plane MCP server using your environment variables. Make sure your environment variables are loaded before running this command.

Step 4: Using Plane MCP with Claude Desktop

If you use Claude Desktop, you can add Plane MCP by changing the claude_desktop_config.json file. Here’s what you add inside the "mcpServers" section:

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

Replace the placeholders with your data. This setup lets Claude Desktop talk to your Plane workspace through Plane MCP.

Step 5: Connect Plane MCP to VSCode

You can also connect Plane MCP to VSCode by editing either .vscode.json or mcp.json. Add this server config:

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

Again, fill in your real keys. This allows VSCode's AI assistant to interact with your Plane projects through Plane MCP.

Summary

To start using Plane MCP:

1. Get your Plane API key and workspace slug.
2. Set environment variables with your keys.
3. Run the server with npx -y @makeplane/plane-mcp-server.
4. For Claude Desktop or VSCode, add the provided JSON config and fill your keys.

This setup connects your AI tools or software directly to Plane, making it easy to automate and manage your work.