kanban-mcp

🔄 Kanban MCP

Welcome to the Kanban MCP project! 🎉 This project integrates Planka kanban boards with Cursor's Machine Control Protocol (MCP) to enable AI assistants like Claude to manage your kanban boards.

🤔 What is Kanban MCP?

Kanban MCP is a bridge between Planka (an open-source kanban board) and Cursor's Machine Control Protocol. It allows AI assistants like Claude to:

• View and manage projects, boards, lists, and cards
• Create and update tasks
• Add comments to cards
• Move cards between lists
• Track time spent on tasks
• And much more!

🚦 Quick Start

📋 Prerequisites

• Docker for running Planka
• Git for cloning the repository
• Node.js (version 18 or above) and npm for development

📚 Documentation

For Users

• Installation Guide: How to install and configure Kanban MCP
• Usage Guide: How to use Kanban MCP with Claude
• Capabilities and Strategies: Detailed exploration of MCP server capabilities and LLM interaction strategies
• Troubleshooting: Solutions to common issues

For Developers

• Developer Guide: Information for developers who want to contribute to or modify Kanban MCP
• API Reference: Detailed documentation of the MCP commands and Planka API integration

✨ Features

📂 Project Management

• Create and view projects
• Manage project settings and members

📊 Board Management

• Create, view, and customize boards within projects

📋 List Management

• Create, organize, and reorder lists within boards

🗂️ Card Management

• Create, update, delete, and move cards between lists

⏱️ Time Tracking

• Start, stop, reset stopwatches, and track time spent on tasks

✅ Task Management

• Create, manage, and mark tasks as complete or incomplete

💬 Comment Management

• Add comments to cards for discussion and view comment history

🤖 LLM Interaction Strategies

MCP Kanban supports several workflow strategies for LLM-human collaboration:

1. LLM-Driven Development with Human Review
2. Human-Driven Development with LLM Support
3. Collaborative Grooming and Planning