Beta
The Plane MCP Server is currently in Beta. Some aspects of the API may change.
While MCP is standardized, it is also rapidly evolving. The Plane MCP Server aims to
provide a stable implementation for developers to build robust AI-powered
applications. Please send any issues to support@plane.so.
Prerequisites
Before setting up the Plane MCP Server, ensure you have the following installed:Node.js and npm
- Node.js: Version 20 or later (LTS recommended)
- npm: Comes bundled with Node.js
- npx: Comes bundled with npm
The MCP server uses
npx
to run the mcp-remote
package, which handles the connection to Plane’s MCP server. This is why Node.js and npx are required.Using the Plane MCP Server
Follow these steps to integrate with the Plane MCP Server.Claude.ai
- Open Settings from the sidebar on the web or desktop app.
- Scroll to the Integrations section and click Add more.
- Enter the Integration URL:
https://mcp.plane.so/sse
- Click Connect to link your Plane workspace.
Claude Desktop
Add Plane to Claude Desktop by updating yourclaude_desktop_config.json
:
VSCode
Connect Plane to VSCode by editing your.vscode.json
or mcp.json
file:
Windsurf
- Press
Ctrl/Cmd + ,
to open Windsurf settings - Navigate to Cascade > MCP servers
- Select Add Server > Add custom server
- Add the following configuration:
Zed
- Press
Cmd + ,
to open Zed settings - Add the following configuration:
Activating the Plane MCP Server
After setup, when activating the server, you will be prompted in your browser to connect your Plane workspace to the MCP server. When prompted to authorize, click Approve. Next, choose the workspace you want to connect, review the permissions, and click Accept.Troubleshooting
Common Issues
Authentication Errors If you encounter authentication issues, clear saved auth tokens:- Ensure you have a stable internet connection
- Check if your firewall or proxy is blocking MCP connections
- Try using the HTTP endpoint instead of SSE if available
Getting Help
If you continue to experience issues:- Verify your authentication credentials
- Contact support at support@plane.so for Plane-specific issues
- Check the MCP community forums for general MCP issues