Skip to content
MCP server

Kanboard MCP

MCP server letting Claude manage tasks on a self-hosted Kanboard board

Runs locally
Install

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.0

Add 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 instanceRequired
  • KANBOARD_USERNAMEKanboard username that owns the personal API tokenRequired
  • KANBOARD_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.

How AIPoweredBot checks servers