planka-v2-mcp

A specialized Model Context Protocol (MCP) server that enables LLMs (like Claude in Cursor) to interact withPlanka v2.xkanban boards.

[!IMPORTANT] This MCP server is designed specifically forPlanka v2.x. It allows an AI agent to manage projects, boards, cards, and the newTask Listhierarchy on an existing Planka instance.

- 📂 Task List Management: Full support for the new Task List entity introduced in Planka v2.0.
- ✅ Granular Task Tracking: Create and complete tasks within specific Task Lists inside cards.
- ⏱️ Persistent Time Tracking: Start and stop stopwatches on cards; time is tracked directly in Planka.
- 👥 Unified Membership Management: Assign users to cards byEmailorUsernamewithout needing their ID first.
- 🚀 Project-First Defaults: New cards are created astype "project"by default to ensure subtasks and checklists are immediately visible.
- 🗂️ Consolidated Managers: Grouped tools (Card Manager, Project Manager, etc.) to optimize LLM interaction and stay under tool limits.
- 📊 Aggregate Summaries: New tools for comprehensive data retrieval:Tool NameParametersDescriptionget_boardidGet board details.update_boardid,name,backgroundType, etc.Update board settings.delete_boardidDelete a board.get_board_summaryboardId,includeTaskDetails,includeCommentsGet a comprehensive summary of a board including stats.get_project_summaryidGet a summary of all boards in a project.
- 🏷️ Advanced Labeling: Full support for v2.x color palettes and label assignment.

🚀 Quick Start (Connect to your Planka v2.x)

- A functionalPlanka v2.xinstance reachable via network.
- An agent user created in Planka with the necessary permissions.

2. Configure Your Client (Cursor/Claude/Antigravity)

The easiest way is usingnpx. Add the following to your MCP configuration:

{ "mcpServers": { "planka-mcp": { "command": "npx", "args": ["-y", "@navyatec/planka-v2-mcp@latest"], "env": { "PLANKA_BASE_URL": "https://your-planka-instance.com", "PLANKA_AGENT_EMAIL": "agent@yourdomain.com", "PLANKA_AGENT_PASSWORD": "your-secure-password", "PLANKA_IGNORE_SSL": "true" } } } }

If you have the code locally, pointing to the built file:

{ "mcpServers": { "planka-mcp": { "command": "node", "args": ["/absolute/path/to/kanban-mcp/dist/index.js"], "env": { ... } } } }

- "Groom the Backlog board and break down the top card into tasks."
- "Start tracking time for the 'UI Implementation' card."
- "Assign @jane.doe to the card 'Implement API Authentication'."
- "Create a new 'Database' Task List in the 'System Migration' card."

- Installation Guide: Detailed setup for the MCP server.
- API Reference: List of available consolidated manager tools.
- Usage Guide: How to interact with the board via LLM.
- Developer Guide: Architecture and how to extend the MCP.

# Install dependencies npm install # Build the project npm run build # Run in development mode npm run dev # Run quality checks npm run qc ### 🚀 Automated Releases This project is configured for automated releases via GitHub Actions. Pushing a tag in the format v (e.g., v1.3.4) will automatically build, test, and publish the package to NPM and create a GitHub Release.

This project focuses exclusively on the MCP interface. For Planka server setup, refer to theofficial Planka documentation.*Developed byNAVYA TECNOLOGÍA 2024, S.L.

Interact with Asana tasks, projects, workspaces, and comments using the Asana API.