Planka MCP

io.github.omnicoreos/planka-mcp · v0.3.0

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

Website Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add planka-mcp -e PLANKA_BASE_URL=<PLANKA_BASE_URL> -e PLANKA_API_KEY=<PLANKA_API_KEY> -e PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL> -e PLANKA_AGENT_PASSWORD=<PLANKA_AGENT_PASSWORD> -e PLANKA_DEFAULT_BOARD_ID=<PLANKA_DEFAULT_BOARD_ID> -e PLANKA_ALLOWED_BOARD_IDS=<PLANKA_ALLOWED_BOARD_IDS> -e PLANKA_ALLOWED_PROJECT_IDS=<PLANKA_ALLOWED_PROJECT_IDS> -e PLANKA_READ_ONLY=<PLANKA_READ_ONLY> -e PLANKA_DISABLED_TOOLS=<PLANKA_DISABLED_TOOLS> -e PLANKA_PROTECTED_LIST_IDS=<PLANKA_PROTECTED_LIST_IDS> -e PLANKA_HIDE_DEPRECATED=<PLANKA_HIDE_DEPRECATED> -e PLANKA_SUMMARY_HIGHLIGHT_LABEL=<PLANKA_SUMMARY_HIGHLIGHT_LABEL> -e PLANKA_SUMMARY_DECISION_LISTS=<PLANKA_SUMMARY_DECISION_LISTS> -- npx -y @omnicoreos/[email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "planka-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/[email protected]"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_EMAIL": "<PLANKA_AGENT_EMAIL>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>",
        "PLANKA_DEFAULT_BOARD_ID": "<PLANKA_DEFAULT_BOARD_ID>",
        "PLANKA_ALLOWED_BOARD_IDS": "<PLANKA_ALLOWED_BOARD_IDS>",
        "PLANKA_ALLOWED_PROJECT_IDS": "<PLANKA_ALLOWED_PROJECT_IDS>",
        "PLANKA_READ_ONLY": "<PLANKA_READ_ONLY>",
        "PLANKA_DISABLED_TOOLS": "<PLANKA_DISABLED_TOOLS>",
        "PLANKA_PROTECTED_LIST_IDS": "<PLANKA_PROTECTED_LIST_IDS>",
        "PLANKA_HIDE_DEPRECATED": "<PLANKA_HIDE_DEPRECATED>",
        "PLANKA_SUMMARY_HIGHLIGHT_LABEL": "<PLANKA_SUMMARY_HIGHLIGHT_LABEL>",
        "PLANKA_SUMMARY_DECISION_LISTS": "<PLANKA_SUMMARY_DECISION_LISTS>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "planka-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/[email protected]"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_EMAIL": "<PLANKA_AGENT_EMAIL>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>",
        "PLANKA_DEFAULT_BOARD_ID": "<PLANKA_DEFAULT_BOARD_ID>",
        "PLANKA_ALLOWED_BOARD_IDS": "<PLANKA_ALLOWED_BOARD_IDS>",
        "PLANKA_ALLOWED_PROJECT_IDS": "<PLANKA_ALLOWED_PROJECT_IDS>",
        "PLANKA_READ_ONLY": "<PLANKA_READ_ONLY>",
        "PLANKA_DISABLED_TOOLS": "<PLANKA_DISABLED_TOOLS>",
        "PLANKA_PROTECTED_LIST_IDS": "<PLANKA_PROTECTED_LIST_IDS>",
        "PLANKA_HIDE_DEPRECATED": "<PLANKA_HIDE_DEPRECATED>",
        "PLANKA_SUMMARY_HIGHLIGHT_LABEL": "<PLANKA_SUMMARY_HIGHLIGHT_LABEL>",
        "PLANKA_SUMMARY_DECISION_LISTS": "<PLANKA_SUMMARY_DECISION_LISTS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "planka-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@omnicoreos/[email protected]"
      ],
      "env": {
        "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
        "PLANKA_API_KEY": "<PLANKA_API_KEY>",
        "PLANKA_AGENT_EMAIL": "<PLANKA_AGENT_EMAIL>",
        "PLANKA_AGENT_PASSWORD": "<PLANKA_AGENT_PASSWORD>",
        "PLANKA_DEFAULT_BOARD_ID": "<PLANKA_DEFAULT_BOARD_ID>",
        "PLANKA_ALLOWED_BOARD_IDS": "<PLANKA_ALLOWED_BOARD_IDS>",
        "PLANKA_ALLOWED_PROJECT_IDS": "<PLANKA_ALLOWED_PROJECT_IDS>",
        "PLANKA_READ_ONLY": "<PLANKA_READ_ONLY>",
        "PLANKA_DISABLED_TOOLS": "<PLANKA_DISABLED_TOOLS>",
        "PLANKA_PROTECTED_LIST_IDS": "<PLANKA_PROTECTED_LIST_IDS>",
        "PLANKA_HIDE_DEPRECATED": "<PLANKA_HIDE_DEPRECATED>",
        "PLANKA_SUMMARY_HIGHLIGHT_LABEL": "<PLANKA_SUMMARY_HIGHLIGHT_LABEL>",
        "PLANKA_SUMMARY_DECISION_LISTS": "<PLANKA_SUMMARY_DECISION_LISTS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`PLANKA_BASE_URL` Required	Planka base URL, for example https://planka.example.com
`PLANKA_API_KEY` Optional, secret	Planka API key (X-Api-Key). Recommended: replaces the email/password login
`PLANKA_AGENT_EMAIL` Optional	Email or username of the Planka agent user. Only needed when PLANKA_API_KEY is not set
`PLANKA_AGENT_PASSWORD` Optional, secret	Password of the Planka agent user. Only needed when PLANKA_API_KEY is not set
`PLANKA_DEFAULT_BOARD_ID` Optional	Board id used when a tool call omits boardId
`PLANKA_ALLOWED_BOARD_IDS` Optional	Comma-separated board ids this server may see and touch. Everything else is hidden
`PLANKA_ALLOWED_PROJECT_IDS` Optional	Comma-separated project ids this server may see. Everything else is hidden
`PLANKA_READ_ONLY` Optional	Set to true to hide and refuse every write tool
`PLANKA_DISABLED_TOOLS` Optional	Comma-separated tool names to switch off, for example planka_get_board
`PLANKA_PROTECTED_LIST_IDS` Optional	Comma-separated list ids that must not receive cards nor be edited or deleted
`PLANKA_HIDE_DEPRECATED` Optional	Set to true to drop the deprecated tool aliases from tools/list. They stay callable
`PLANKA_SUMMARY_HIGHLIGHT_LABEL` Optional	Label planka_board_summary flags as unblocked/ready. Unset: no highlighting
`PLANKA_SUMMARY_DECISION_LISTS` Optional	Comma-separated columns planka_board_summary returns cards from when the call does not say

Details

Package	`@omnicoreos/[email protected]` (NPM, stdio)
First published	3 Sep 2026
Last updated	3 Sep 2026
Registry name	`io.github.omnicoreos/planka-mcp`

More productivity servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Planka MCP often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-omnicoreos-planka-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-omnicoreos-planka-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.