MCP server
Planka MCP
Planka 2.x MCP server with verified card, task, comment, label, and list operations.
Runs locallyStatus and history
- 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-mcpAdd 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.comRequiredPLANKA_API_KEYPlanka API key (X-Api-Key). Recommended: replaces the email/password loginPLANKA_AGENT_EMAILEmail or username of the Planka agent user. Only needed when PLANKA_API_KEY is not setPLANKA_AGENT_PASSWORDPassword of the Planka agent user. Only needed when PLANKA_API_KEY is not setPLANKA_DEFAULT_BOARD_IDBoard id used when a tool call omits boardIdPLANKA_ALLOWED_BOARD_IDSComma-separated board ids this server may see and touch. Everything else is hiddenPLANKA_ALLOWED_PROJECT_IDSComma-separated project ids this server may see. Everything else is hiddenPLANKA_READ_ONLYSet to true to hide and refuse every write toolPLANKA_DISABLED_TOOLSComma-separated tool names to switch off, for example planka_get_boardPLANKA_PROTECTED_LIST_IDSComma-separated list ids that must not receive cards nor be edited or deletedPLANKA_HIDE_DEPRECATEDSet to true to drop the deprecated tool aliases from tools/list. They stay callablePLANKA_SUMMARY_HIGHLIGHT_LABELLabel planka_board_summary flags as unblocked/ready. Unset: no highlightingPLANKA_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