Planka MCP Server
by omnicoreosio.github.omnicoreos/planka-mcpv0.3.0
Planka 2.x MCP server with verified card, task, comment, label, and list operations.
context tax
queued
security
queued
cold start
queued
freshness
Maintained37d ago
Install Planka MCP server
Install in Claude Code
claude mcp add planka-omnicoreos -e PLANKA_BASE_URL='<planka-base-url>' -e PLANKA_API_KEY='<planka-api-key>' -e PLANKA_AGENT_PASSWORD='<planka-agent-password>' -- npx -y @omnicoreos/planka-mcpInstall in Cursor
{
"mcpServers": {
"planka-omnicoreos": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"planka-omnicoreos": {
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"planka-omnicoreos": {
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"planka-omnicoreos": {
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| PLANKA_BASE_URL | yes | — | Planka base URL, for example https://planka.example.com |
| PLANKA_API_KEY | — | yes | Planka API key (X-Api-Key). Recommended: replaces the email/password login |
| PLANKA_AGENT_EMAIL | — | — | Email or username of the Planka agent user. Only needed when PLANKA_API_KEY is not set |
| PLANKA_AGENT_PASSWORD | — | yes | Password of the Planka agent user. Only needed when PLANKA_API_KEY is not set |
| PLANKA_DEFAULT_BOARD_ID | — | — | Board id used when a tool call omits boardId |
| PLANKA_ALLOWED_BOARD_IDS | — | — | Comma-separated board ids this server may see and touch. Everything else is hidden |
| PLANKA_ALLOWED_PROJECT_IDS | — | — | Comma-separated project ids this server may see. Everything else is hidden |
| PLANKA_READ_ONLY | — | — | Set to true to hide and refuse every write tool |
| PLANKA_DISABLED_TOOLS | — | — | Comma-separated tool names to switch off, for example planka_get_board |
| PLANKA_PROTECTED_LIST_IDS | — | — | Comma-separated list ids that must not receive cards nor be edited or deleted |
| PLANKA_HIDE_DEPRECATED | — | — | Set to true to drop the deprecated tool aliases from tools/list. They stay callable |
| PLANKA_SUMMARY_HIGHLIGHT_LABEL | — | — | Label planka_board_summary flags as unblocked/ready. Unset: no highlighting |
| PLANKA_SUMMARY_DECISION_LISTS | — | — | Comma-separated columns planka_board_summary returns cards from when the call does not say |
Freshness
Maintained — last maintenance signal 37d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-03 · 37d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-03 · 37d ago · official registry · v0.3.0
FAQ
›How do I install the Planka MCP server in Claude Code?
Run: claude mcp add planka-omnicoreos -e PLANKA_BASE_URL='<planka-base-url>' -e PLANKA_API_KEY='<planka-api-key>' -e PLANKA_AGENT_PASSWORD='<planka-agent-password>' -- npx -y @omnicoreos/planka-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Planka require an API key?
Yes. It expects PLANKA_BASE_URL, PLANKA_API_KEY, PLANKA_AGENT_PASSWORD, of which 2 are secrets.
›Can I use Planka as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Planka in the official MCP registry?
Yes, as io.github.omnicoreos/planka-mcp.