MCP server for PLANKA kanban boards. Full CRUD for cards, tasks, comments, and labels.
A Model Context Protocol (MCP) server for PLANKA kanban boards, purpose-built for Claude and other AI agents.
npm install @gogogadgetbytes/planka-mcp
Or run directly:
npx @gogogadgetbytes/planka-mcp
| 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 |
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": "agent@example.com",
"PLANKA_AGENT_PASSWORD": "your-password"
}
}
}
}
Add to ~/.claude.json:
{
"mcpServers": {
"planka": {
"command": "npx",
"args": ["@gogogadgetbytes/planka-mcp"],
"env": {
"PLANKA_BASE_URL": "https://planka.example.com",
"PLANKA_AGENT_EMAIL": "agent@example.com",
"PLANKA_AGENT_PASSWORD": "your-password"
}
}
}
}
| Tool | Description |
|---|---|
planka_get_structure | Get projects, boards, and lists hierarchy |
planka_get_board | Get a board with all cards, lists, and labels |
| 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 |
| 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 |
| Tool | Description |
|---|---|
planka_manage_labels | Create/update/delete board labels |
planka_set_card_labels | Add/remove labels from a card |
| Tool | Description |
|---|---|
planka_add_comment | Add a comment to a card |
planka_get_comments | Get all comments on a card |
| Tool | Description |
|---|---|
planka_manage_lists | Create/update/delete lists |
Use planka_get_structure to see all projects and boards
Use planka_create_card with:
- listId: "abc123"
- name: "Implement feature X"
- tasks: ["Research", "Design", "Implement", "Test"]
Use planka_move_card to move card from "To Do" to "In Progress"
This server is designed for PLANKA 2.0 and handles the API differences from 1.x:
type field/card-labels path# Clone
git clone https://github.com/gogogadgetbytes/planka-mcp.git
cd planka-mcp
# Install
npm install
# Build
npm run build
# Test
npm test
MIT
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @gogogadgetbytes/planka-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-gogogadgetbytes-planka": {
"command": "npx",
"args": [
"-y",
"@gogogadgetbytes/planka-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup reference@gogogadgetbytes/planka-mcpnpmio.github.gogogadgetbytes/planka works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.