planka-mcp by AcceleratedIndustries - MCP Server

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="admin@example.com"
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

Tool	Description	Programmatic
`list_projects`	List all Planka projects	Yes
`list_boards`	List boards in a project	Yes
`list_lists`	List columns on a board	Yes
`list_cards`	List cards on a board	Yes
`create_board`	Create a new board (requires Project Manager role)	Yes
`create_list`	Create a new column on a board	Yes
`create_card`	Create a new card in a list	Yes
`update_card`	Update card name/description	Yes
`move_card`	Move card to different list	Yes
`delete_card`	Delete a card	No
`delete_list`	Delete a list and all its cards	No

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": "user@example.com",
        "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 card
set_due_date - Set card due date
add_label - Add label to a card

License

MIT