Skip to content
MCP server

Planka MCP

Planka 2.x MCP server with verified card, task, comment, label, and list operations.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.3.0
Listing updated
4 days ago

About Planka MCP

Planka MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add planka-mcp --env PLANKA_BASE_URL='<PLANKA_BASE_URL>' --env PLANKA_API_KEY='<PLANKA_API_KEY>' --env PLANKA_AGENT_PASSWORD='<PLANKA_AGENT_PASSWORD>' -- npx -y @omnicoreos/planka-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "planka-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/planka-mcp"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "planka-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/planka-mcp"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "planka-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/planka-mcp"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "planka-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/planka-mcp"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "planka-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/planka-mcp"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>"
      }
    }
  }
}

Configuration

  • PLANKA_BASE_URLPlanka base URL, for example https://planka.example.comRequired
  • PLANKA_API_KEYPlanka API key (X-Api-Key). Recommended: replaces the email/password login
  • PLANKA_AGENT_EMAILEmail or username of the Planka agent user. Only needed when PLANKA_API_KEY is not set
  • PLANKA_AGENT_PASSWORDPassword of the Planka agent user. Only needed when PLANKA_API_KEY is not set
  • PLANKA_DEFAULT_BOARD_IDBoard id used when a tool call omits boardId
  • PLANKA_ALLOWED_BOARD_IDSComma-separated board ids this server may see and touch. Everything else is hidden
  • PLANKA_ALLOWED_PROJECT_IDSComma-separated project ids this server may see. Everything else is hidden
  • PLANKA_READ_ONLYSet to true to hide and refuse every write tool
  • PLANKA_DISABLED_TOOLSComma-separated tool names to switch off, for example planka_get_board
  • PLANKA_PROTECTED_LIST_IDSComma-separated list ids that must not receive cards nor be edited or deleted
  • PLANKA_HIDE_DEPRECATEDSet to true to drop the deprecated tool aliases from tools/list. They stay callable
  • PLANKA_SUMMARY_HIGHLIGHT_LABELLabel planka_board_summary flags as unblocked/ready. Unset: no highlighting
  • PLANKA_SUMMARY_DECISION_LISTSComma-separated columns planka_board_summary returns cards from when the call does not say

Pricing

Open source

Planka MCP FAQ

Is Planka MCP free?

Yes. Planka MCP is open source, so you can use and self-host it for free.

How do I add Planka MCP to Claude Code?

Run this command in your terminal: claude mcp add planka-mcp --env PLANKA_BASE_URL='<PLANKA_BASE_URL>' --env PLANKA_API_KEY='<PLANKA_API_KEY>' --env PLANKA_AGENT_PASSWORD='<PLANKA_AGENT_PASSWORD>' -- npx -y @omnicoreos/planka-mcp