About planka
planka is an MCP server for PLANKA 2.0 kanban boards, intended for Claude and other AI agents. It provides tools to navigate boards and manage cards, tasks, labels, comments, and lists.
Key features
- 01Browse projects, boards, and lists
- 02Create, update, move, and delete cards
- 03Manage card tasks and labels
- 04Add and retrieve card comments
- 05Create, update, and delete lists
- 06Zod-validated PLANKA 2.0 API support
Use cases
- 01Review board and list structure
- 02Create a card with checklist tasks
- 03Move cards through a workflow
- 04Update labels or comments on cards
MCP support
Exposes 13 tools for PLANKA board navigation and CRUD operations to MCP clients, including tools for cards, tasks, labels, comments, and lists.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @gogogadgetbytes/planka-mcpPLANKA_BASE_URLPLANKA server URL (e.g., https://planka.example.com)PLANKA_AGENT_EMAILEmail/username for PLANKA authenticationPLANKA_AGENT_PASSWORDSecretPassword for PLANKA authenticationLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
15Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| projectId | string | No | Optional: Get structure for a specific project only |
Details
From the project READMEPLANKA MCP Server
A Model Context Protocol (MCP) server for PLANKA kanban boards, purpose-built for Claude and other AI agents.
Features
- Full PLANKA 2.0 API support
- Type-safe with Zod validation
- Optimized for agent workflows (combined operations, sensible defaults)
- 13 tools covering cards, tasks, labels, comments, and lists
Installation
npm install @gogogadgetbytes/planka-mcp
Or run directly:
npx @gogogadgetbytes/planka-mcp
Configuration
Environment Variables
| Variable | Required | Description |
|---|---|---|
PLANKA_BASE_URL | Yes | Your PLANKA server URL |
PLANKA_AGENT_EMAIL | Yes | Agent user email |
PLANKA_AGENT_PASSWORD | Yes | Agent user password |
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"planka": {
"command": "npx",
"args": ["@gogogadgetbytes/planka-mcp"],
"env": {
"PLANKA_BASE_URL": "https://planka.example.com",
"PLANKA_AGENT_EMAIL": "[email protected]",
"PLANKA_AGENT_PASSWORD": "your-password"
}
}
}
}
Claude Code
Add to ~/.claude.json:
{
"mcpServers": {
"planka": {
"command": "npx",
"args": ["@gogogadgetbytes/planka-mcp"],
"env": {
"PLANKA_BASE_URL": "https://planka.example.com",
"PLANKA_AGENT_EMAIL": "[email protected]",
"PLANKA_AGENT_PASSWORD": "your-password"
}
}
}
}
Available Tools
Navigation
| Tool | Description |
|---|---|
planka_get_structure | Get projects, boards, and lists hierarchy |
planka_get_board | Get a board with all cards, lists, and labels |
Cards
| Tool | Description |
|---|---|
planka_create_card | Create a card (optionally with tasks) |
planka_update_card | Update card properties |
planka_move_card | Move card to different list/position |
planka_get_card | Get card details with tasks/comments |
planka_delete_card | Delete a card |
Tasks
| Tool | Description |
|---|---|
planka_create_tasks | Add tasks (checklist items) to a card |
planka_update_task | Update task name or completion |
planka_delete_task | Delete a task |
Labels
| Tool | Description |
|---|---|
planka_manage_labels | Create/update/delete board labels |
planka_set_card_labels | Add/remove labels from a card |
Comments
| Tool | Description |
|---|---|
planka_add_comment | Add a comment to a card |
planka_get_comments | Get all comments on a card |
Lists
| Tool | Description |
|---|---|
planka_manage_lists | Create/update/delete lists |
Usage Examples
Get board structure
Use planka_get_structure to see all projects and boards
Create a card with tasks
Use planka_create_card with:
- listId: "abc123"
- name: "Implement feature X"
- tasks: ["Research", "Design", "Implement", "Test"]
Move card through workflow
Use planka_move_card to move card from "To Do" to "In Progress"
PLANKA 2.0 Compatibility
This server is designed for PLANKA 2.0 and handles the API differences from 1.x:
- Card creation includes required
typefield - Label endpoints use
/card-labelspath - Optional fields handled gracefully
Development
# Clone
git clone https://github.com/gogogadgetbytes/planka-mcp.git
cd planka-mcp
# Install
npm install
# Build
npm run build
# Test
npm test
License
MIT
Links
- PLANKA - The kanban board
- MCP SDK - Model Context Protocol
- Design Document - Technical design details
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.