planka-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@planka-mcpCreate a card 'Review PR' in the To Do list."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PLANKA 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
Related MCP server: Another Planka MCP
Installation
npm install @gogogadgetbytes/planka-mcpOr run directly:
npx @gogogadgetbytes/planka-mcpConfiguration
Environment Variables
Variable | Required | Description |
| Yes | Your PLANKA server URL |
| Yes | Agent user email |
| 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": "agent@example.com",
"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": "agent@example.com",
"PLANKA_AGENT_PASSWORD": "your-password"
}
}
}
}Available Tools
Navigation
Tool | Description |
| Get projects, boards, and lists hierarchy |
| Get a board with all cards, lists, and labels |
Cards
Tool | Description |
| Create a card (optionally with tasks) |
| Update card properties |
| Move card to different list/position |
| Get card details with tasks/comments |
| Delete a card |
Tasks
Tool | Description |
| Add tasks (checklist items) to a card |
| Update task name or completion |
| Delete a task |
Labels
Tool | Description |
| Create/update/delete board labels |
| Add/remove labels from a card |
Comments
Tool | Description |
| Add a comment to a card |
| Get all comments on a card |
Lists
Tool | Description |
| Create/update/delete lists |
Usage Examples
Get board structure
Use planka_get_structure to see all projects and boardsCreate 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
typefieldLabel endpoints use
/card-labelspathOptional 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 testLicense
MIT
Links
PLANKA - The kanban board
MCP SDK - Model Context Protocol
Design Document - Technical design details
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/gogogadgetbytes/planka-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server