Kanboard MCP
MCP server letting Claude manage tasks on a self-hosted Kanboard board
Kanboard MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
- Pricing
- Open source
- Platforms
- CLI, API, macOS
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add kanboard-mcp-server --env KANBOARD_URL='<KANBOARD_URL>' --env KANBOARD_USERNAME='<KANBOARD_USERNAME>' --env KANBOARD_API_TOKEN='<KANBOARD_API_TOKEN>' -- docker run -i --rm -e KANBOARD_URL -e KANBOARD_USERNAME -e KANBOARD_API_TOKEN ghcr.io/b-ak/kanboard-mcp-server:0.2.0Add to claude_desktop_config.json
{
"mcpServers": {
"kanboard-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KANBOARD_URL",
"-e",
"KANBOARD_USERNAME",
"-e",
"KANBOARD_API_TOKEN",
"ghcr.io/b-ak/kanboard-mcp-server:0.2.0"
],
"env": {
"KANBOARD_URL": "<KANBOARD_URL>",
"KANBOARD_USERNAME": "<KANBOARD_USERNAME>",
"KANBOARD_API_TOKEN": "<KANBOARD_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"kanboard-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KANBOARD_URL",
"-e",
"KANBOARD_USERNAME",
"-e",
"KANBOARD_API_TOKEN",
"ghcr.io/b-ak/kanboard-mcp-server:0.2.0"
],
"env": {
"KANBOARD_URL": "<KANBOARD_URL>",
"KANBOARD_USERNAME": "<KANBOARD_USERNAME>",
"KANBOARD_API_TOKEN": "<KANBOARD_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"kanboard-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KANBOARD_URL",
"-e",
"KANBOARD_USERNAME",
"-e",
"KANBOARD_API_TOKEN",
"ghcr.io/b-ak/kanboard-mcp-server:0.2.0"
],
"env": {
"KANBOARD_URL": "<KANBOARD_URL>",
"KANBOARD_USERNAME": "<KANBOARD_USERNAME>",
"KANBOARD_API_TOKEN": "<KANBOARD_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"kanboard-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KANBOARD_URL",
"-e",
"KANBOARD_USERNAME",
"-e",
"KANBOARD_API_TOKEN",
"ghcr.io/b-ak/kanboard-mcp-server:0.2.0"
],
"env": {
"KANBOARD_URL": "<KANBOARD_URL>",
"KANBOARD_USERNAME": "<KANBOARD_USERNAME>",
"KANBOARD_API_TOKEN": "<KANBOARD_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"kanboard-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KANBOARD_URL",
"-e",
"KANBOARD_USERNAME",
"-e",
"KANBOARD_API_TOKEN",
"ghcr.io/b-ak/kanboard-mcp-server:0.2.0"
],
"env": {
"KANBOARD_URL": "<KANBOARD_URL>",
"KANBOARD_USERNAME": "<KANBOARD_USERNAME>",
"KANBOARD_API_TOKEN": "<KANBOARD_API_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
KANBOARD_URLBase URL of your Kanboard instanceRequiredKANBOARD_USERNAMEKanboard username that owns the personal API tokenRequiredKANBOARD_API_TOKENKanboard personal API token (My profile → API)Required
About Kanboard MCP
Kanboard MCP connects Claude to a Kanboard instance you run yourself, so you can create, update, move and track tasks from Claude Code, Claude Desktop, claude.ai or the Claude mobile apps. It talks to Kanboard only through its JSON-RPC API, which means it can reach any Kanboard install you can access over HTTP, whether on localhost, a LAN or a public address, and it is not tied to a particular database backend.
The server exposes read tools for projects, boards, overdue work and attachments, plus write tools for tasks, subtasks, comments and column moves. Read-only tools are marked as such so clients can approve them automatically while asking before changes. Authentication can use a personal API token that acts as you and respects project permissions, or an application token with broader access.
It suits teams and individuals who already run Kanboard and want to let an AI assistant handle routine board upkeep. For remote use from claude.ai or mobile, the server must be exposed over HTTPS behind a tunnel or proxy and protected with login.
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- list_projects
- Projects with IDs and board links
- get_board
- Columns of a project with their open tasks
- list_tasks
- Tasks in a project, filtered by open, closed or all and column
- search_tasks
- Search tasks using Kanboard filter syntax, in one or all projects
- get_overdue_tasks
- Overdue tasks, for you or for one project
- get_task
- Details, tags, subtasks, comments and attachment list
- get_task_file
- Read an attachment as image or text
- create_task
- Create a task with title, description, priority, column, assignee, due date and tags
- update_task
- Update a task's fields
- move_task
- Move a task to another column by name
- close_task
- Complete a task
- reopen_task
- Reopen a task
- add_comment
- Add a Markdown progress note to a task
- create_subtask
- Create a checklist item
- update_subtask
- Update a checklist item's status
- list_project_users
- List assignable users
- get_me
- Show the Kanboard user and API mode in use
What it does
- Task creation and updates
- Create and edit tasks with title, description, priority, column, assignee, due date and tags.
- Board and project overview
- List projects and view each column with its open tasks.
- Flexible task search
- Search with Kanboard filter syntax across one project or all projects, including overdue lookups.
- Column moves and completion
- Move tasks between columns by name and close or reopen them.
- Comments and checklists
- Add Markdown progress notes and manage subtasks with their status.
- Attachment reading
- Read task attachments, with images returned as images and text files as text.
- Read-only auto-approval
- Read-only tools are annotated so Claude clients can run them without prompting.
Good for
- Asking Claude to create tasks from a conversation and place them on the right board
- Checking which tasks are overdue or due today across all projects
- Moving finished work to a done column and adding a progress comment
- Breaking a task into checklist subtasks and updating their status
- Reviewing a project's open tasks before a planning meeting
Pricing
Open source
Free and open source under Apache-2.0; you host it yourself.
Kanboard MCP FAQ
Which Kanboard setups does Kanboard MCP work with?
Any Kanboard instance reachable over HTTP, including localhost, LAN or public URLs, and any Kanboard database backend.
What is the difference between the two token types?
A personal access token acts as your user and follows your project permissions. An application token has full access to every project and needs a default user ID for comment authorship.
Can I use Kanboard MCP from claude.ai or the mobile apps?
Yes, but the server must run where it can reach Kanboard, be available at a public HTTPS address, and require login. GitHub OAuth is built in.
How is Kanboard MCP installed for local use?
Add it to Claude Code or Claude Desktop with a uvx command that runs the server from its Git repository, setting the Kanboard URL, username and API token as environment variables.
Is Kanboard MCP free?
Yes. Kanboard MCP is open source, so you can use and self-host it for free.
How do I add Kanboard MCP to Claude Code?
Run this command in your terminal: claude mcp add kanboard-mcp-server --env KANBOARD_URL='<KANBOARD_URL>' --env KANBOARD_USERNAME='<KANBOARD_USERNAME>' --env KANBOARD_API_TOKEN='<KANBOARD_API_TOKEN>' -- docker run -i --rm -e KANBOARD_URL -e KANBOARD_USERNAME -e KANBOARD_API_TOKEN ghcr.io/b-ak/kanboard-mcp-server:0.2.0
What are the best alternatives to Kanboard MCP?
The closest alternatives to Kanboard MCP are kanopy, Kanban AI, Planka MCP, craaft and Kaiten MCP.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.