Official Plane server to automate Plane projects, work items, cycles and more.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add plane --env PLANE_API_KEY='<PLANE_API_KEY>' --env PLANE_WORKSPACE_SLUG='<PLANE_WORKSPACE_SLUG>' --env PLANE_BASE_URL='<PLANE_BASE_URL>' -- uvx plane-mcp-server stdio~/.codex/config.toml
[mcp_servers.plane]
command = "uvx"
args = ["plane-mcp-server", "stdio"]
env = { PLANE_API_KEY = "<PLANE_API_KEY>", PLANE_WORKSPACE_SLUG = "<PLANE_WORKSPACE_SLUG>", PLANE_BASE_URL = "<PLANE_BASE_URL>" }
# codex mcp add plane --env PLANE_API_KEY='<PLANE_API_KEY>' --env PLANE_WORKSPACE_SLUG='<PLANE_WORKSPACE_SLUG>' --env PLANE_BASE_URL='<PLANE_BASE_URL>' -- uvx plane-mcp-server stdio~/.cursor/mcp.json
{
"mcpServers": {
"plane": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<PLANE_API_KEY>",
"PLANE_WORKSPACE_SLUG": "<PLANE_WORKSPACE_SLUG>",
"PLANE_BASE_URL": "<PLANE_BASE_URL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"plane": {
"type": "stdio",
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<PLANE_API_KEY>",
"PLANE_WORKSPACE_SLUG": "<PLANE_WORKSPACE_SLUG>",
"PLANE_BASE_URL": "<PLANE_BASE_URL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"plane": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<PLANE_API_KEY>",
"PLANE_WORKSPACE_SLUG": "<PLANE_WORKSPACE_SLUG>",
"PLANE_BASE_URL": "<PLANE_BASE_URL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"plane": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<PLANE_API_KEY>",
"PLANE_WORKSPACE_SLUG": "<PLANE_WORKSPACE_SLUG>",
"PLANE_BASE_URL": "<PLANE_BASE_URL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"plane": {
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
],
"env": {
"PLANE_API_KEY": "<PLANE_API_KEY>",
"PLANE_WORKSPACE_SLUG": "<PLANE_WORKSPACE_SLUG>",
"PLANE_BASE_URL": "<PLANE_BASE_URL>"
}
}
}
}Environment variables
PLANE_API_KEYPLANE_WORKSPACE_SLUGPLANE_BASE_URL
Replace the placeholders with your own credentials and keep them out of version control.