Server data from the Official MCP Registry
MCP server for PLANKA kanban boards. Full CRUD for cards, tasks, comments, and labels.
About
MCP server for PLANKA kanban boards. Full CRUD for cards, tasks, comments, and labels.
Security Report
Valid MCP server (1 strong, 1 medium validity signals). 3 known CVEs in dependencies (0 critical, 2 high severity) Package registry verified. Imported from the Official MCP Registry.
10 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: PLANKA_BASE_URL
Environment variable: PLANKA_AGENT_EMAIL
Environment variable: PLANKA_AGENT_PASSWORD
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-gogogadgetbytes-planka": {
"env": {
"PLANKA_BASE_URL": "your-planka-base-url-here",
"PLANKA_AGENT_EMAIL": "your-planka-agent-email-here",
"PLANKA_AGENT_PASSWORD": "your-planka-agent-password-here"
},
"args": [
"-y",
"@gogogadgetbytes/planka-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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
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": "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 |
|---|---|
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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption