planka-mcp
A Model Context Protocol (MCP) server for Planka kanban boards, written in Rust.
Installation
From GitHub (recommended)
cargo install --git https://github.com/AcceleratedIndustries/planka-mcp
From source
git clone https://github.com/AcceleratedIndustries/planka-mcp
cd planka-mcp
cargo build --release
Setup
Environment Variables
export PLANKA_URL="https://kanban.local"
# Option 1: Bearer token (preferred)
export PLANKA_TOKEN="your-token-here"
# Option 2: Email/password authentication
export PLANKA_EMAIL="[email protected]"
export PLANKA_PASSWORD="your-password"
Run
# If installed via cargo install:
planka-mcp
# If built from source:
./target/release/planka-mcp
MCP Client Configuration
Add to your MCP client configuration:
{
"mcpServers": {
"planka": {
"command": "/path/to/planka-mcp",
"env": {
"PLANKA_URL": "https://kanban.local",
"PLANKA_TOKEN": "your-token"
}
}
}
}
Available Tools
Programmatic Tool Calling (Beta)
This server supports Anthropic's programmatic tool calling beta feature, which allows Claude to write Python code that orchestrates multiple tool calls efficiently.
Most tools are enabled for programmatic calling via allowed_callers: ["code_execution_20250825"]. Delete operations are excluded for safety.
Enabling in the Anthropic API
import anthropic
client = anthropic.Anthropic()
response = client.beta.messages.create(
betas=["advanced-tool-use-2025-11-20"],
model="claude-sonnet-4-5-20250929",
max_tokens=4096,
tools=[
{"type": "code_execution_20250825", "name": "code_execution"},
# Include your planka-mcp tools here with their schemas
]
)
Example Use Cases
With programmatic calling enabled, Claude can efficiently handle batch operations:
- "Move all cards containing 'blocked' to the Blocked column"
- "Create cards for each item in this list"
- "Find all cards assigned to me across all boards"
Claude Code Integration
Add to ~/.claude/mcp.json:
{
"mcpServers": {
"planka": {
"command": "/path/to/planka-mcp",
"env": {
"PLANKA_URL": "https://kanban.local",
"PLANKA_EMAIL": "[email protected]",
"PLANKA_PASSWORD": "your-password"
}
}
}
}
Then restart Claude Code or run /mcp to see the server.
Extending
To add new tools:
- Add HTTP method to
src/planka/client.rs - Add any new types to
src/planka/types.rs - Add tool definition and handler to
src/tools/mod.rs
Future tools to consider:
add_comment- Add comment to a cardset_due_date- Set card due dateadd_label- Add label to a card
License
MIT