Kanban MCP

🚀 MCP Kanban

An MCP toolset that provides internal task management status, suitable for AI agents in complex multi - session workflows. Similar to other memory MCP tools, it adds a kanban - style task management system structure, rules, and visibility.

🚀 Quick Start

The main idea is to guide AI agents to record and save their work in a kanban, whether it's planning or executing a meeting.

✨ Features

• Column capacity / work progress limits
• Embedded database (SQLite)
• Web UI for observing work progress and manually modifying tasks
• Pre - defined prompts for starting and resuming workflows

💻 Usage Examples

Basic Usage

Use MCP prompts to start a project or make progress on an existing one. Alternatively, have the large language model assistant record its plans by creating a kanban. To continue work in subsequent meetings, instruct the assistant to locate a specific kanban and resume work.

Advanced Usage

• Create a project based on a kanban: Create a kanban, break the project into tasks by asking questions, and add them to the kanban.
• Make progress on an existing project: Locate its kanban, select the next task, and work on it.

📦 Installation

Manual Installation

Clone this repository and then run:

npm ci --prefix shared/db
npm ci --prefix mcp-server
npm run build --prefix shared/db
npm run build --prefix mcp-server

Then add the MCP server configuration to the MCP client (e.g., Claude Desktop):

"mcpServers": {
    "kanban-mcp": {
        "command": "node",
        "args": [
            "/path/to/repo/mcp-server/dist/server.js"
        ],
        "env": {
            "MCP_KANBAN_DB_FOLDER_PATH": "/path/to/db"
        }
    }
}

Replace /path/to/repo with the actual path of the cloned repository. Replace /path/to/db with the folder where you want to store the DB files. This can be any folder with read - write permissions. If it doesn't exist, it will be created.

Docker Installation

Build the Docker image:

docker build -t mcp/mcp-kanban .

Then add the MCP server configuration to the MCP client (e.g., Claude Desktop):

"mcpServers": {
    "kanban-mcp": {
        "command": "docker",
        "args": [
            "run",
            "--rm",
            "-i",
            "-v",
            "/path/to/db:/mcp",
            "mcp/mcp-kanban"
        ]
    }
}

Replace /path/to/db with the folder where you want to store the DB files. This can be any folder with read - write permissions.

Using the Web UI

Build the Web interface and Web server:

npm ci --prefix shared/db
npm run build --prefix shared/db

npm ci --prefix web-ui
npm ci --prefix web-server
npm run build --prefix web-ui
npm run build --prefix web-server

Run the Web server:

node server.js

Then access http://localhost:3000 in your browser.

📚 Documentation

API Tools

Tools

• Create a kanban: Use POST /kanban to create a new kanban.
• Get all kanbans: Use GET /kanban to get a list of all kanbans.
• Update task status: Use PUT /kanban/{boardId}/task/{taskId} to update the status of a specific task.

Tips

• Create a project based on a kanban: Create a kanban, break the project into tasks by asking questions, and add them to the kanban.
• Make progress on an existing project: Locate its kanban, select the next task, and work on it.