charlieplan-mcp

MCP server that connects Planka (self-hosted kanban) to AI assistants.

Why this exists

AI chats are great for processing information — brainstorming, rewriting, distilling ideas from large amounts of text. But the output of that work — decisions, plans, next steps — needs to land somewhere.

Planka is a simple, self-hosted kanban board. This server connects it to your AI workflow: results from chats turn into cards, cards provide context for future chats. The board becomes a persistent layer between sessions.

What it does

Exposes Planka board management as MCP tools: projects, boards, lists, cards, labels, custom fields, task lists, attachments, and card search. Works with any MCP-compatible client (Claude Desktop, Claude.ai, etc.).

When SERVER_URL is configured, the server also enables OAuth and a /redirect endpoint — deep links that bounce from a card directly into a chat with pre-filled context.

Local development

Prerequisites: Docker, Node.js ≥ 22, pnpm, Claude Code

pnpm install

docker compose up -d

docker compose exec postgres psql -U postgres -c 'CREATE DATABASE "charlieplan"'

cp mcp-server/.env.example mcp-server/.env

pnpm build

Open http://localhost:1337 — login admin@example.com / admin123 → Profile → API Keys → create a key.

claude mcp add planka -e PLANKA_API_KEY=<your-key> -- pnpm mcp:stdio

Done. Migrations run automatically on first connection. Verify with claude mcp list.

Self-hosting

See deploy.md.