kantban-mcp

MCP (Model Context Protocol) server for KantBan — manage kanban boards, tickets, documents, and workflows from Claude Code and other MCP clients.

Prerequisites

• Node.js 22+
• A running KantBan API instance
• A KantBan API token

Setup

1. Generate an API Token

In your KantBan app, go to Account Settings > API Tokens and generate a new token. Copy the token — it starts with cb_ and is only shown once.

2. Configure Your MCP Client

Claude Code

Add to your project's .mcp.json (or global ~/.claude/.mcp.json):

{
  "mcpServers": {
    "kantban": {
      "command": "npx",
      "args": ["-y", "kantban-mcp@latest"],
      "env": {
        "KANTBAN_API_TOKEN": "cb_your_token_here",
        "KANTBAN_API_URL": "https://your-kantban-api.example.com"
      }
    }
  }
}

Cursor / Windsurf / Other MCP Clients

Most MCP clients use the same JSON format. Check your client's documentation for where to place the config. The server communicates over stdio using JSON-RPC.

Run Directly

KANTBAN_API_TOKEN=cb_... KANTBAN_API_URL=https://... npx -y kantban-mcp@latest

3. Verify

After configuring, restart your MCP client. You should see KantBan tools available. Try asking your AI assistant to "list my KantBan projects" to verify the connection.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | KANTBAN_API_TOKEN | Yes | API token starting with cb_ — generate from account settings | | KANTBAN_API_URL | Yes | Base URL of your KantBan API (e.g. https://your-app.up.railway.app) |

Available Tools (102)

Projects (2)

list_projects delete_project

Boards (6)

list_boards get_board create_board update_board delete_board get_board_context

Columns (5)

list_columns create_column update_column delete_column reorder_columns

Tickets (18)

list_tickets get_ticket search_tickets create_ticket create_tickets update_ticket update_tickets move_ticket move_tickets export_ticket_markdown delete_ticket archive_ticket archive_tickets unarchive_ticket unarchive_tickets archive_column_tickets list_backlog move_to_board

Comments (5)

list_comments create_comment create_comments update_comment delete_comment

Document Spaces (2)

list_spaces delete_space

Documents (6)

list_documents get_document create_document update_document move_document delete_document

Search (1)

search

Custom Fields (9)

list_fields create_field update_field delete_field list_field_overrides set_field_override get_field_values set_field_value set_field_values

Workflow (7)

list_transition_rules set_transition_rules delete_transition_rule list_transition_requirements set_transition_requirements delete_transition_requirement check_transition

Compound Tools (4)

plan_to_tickets start_working_on complete_task search_documents_chunked

Intelligence (5)

get_project_dashboard detect_bottlenecks get_ticket_context get_ai_activity get_activity_feed

People & Notifications (5)

list_project_members search_users list_notifications mark_notification_read mark_all_notifications_read

References & Attachments (2)

find_references list_attachments

Analytics (3)

get_velocity forecast_completion retrospective_insights

GitHub (4)

detect_current_ticket link_github_reference list_github_references sync_github_references

Pipeline Templates (10)

list_pipeline_templates get_pipeline_template create_pipeline_template update_pipeline_template delete_pipeline_template run_pipeline_template add_template_step update_template_step remove_template_step reorder_template_steps

Transitions (1)

list_transitions

Plugin Ecosystem

When installed as a Claude Code plugin, the package also provides:

• 5 MCP Resources — dashboard, board snapshot, next tasks, project health, recent activity
• 6 MCP Prompts — plan-feature, daily-standup, groom-backlog, link-github, sprint-forecast, run-pipeline-template
• 7 Slash Commands — /plan-feature, /whats-next, /board-health, /schedule-standup, /schedule-health, /schedule-template, /unschedule
• 1 Skill — kantban-assistant with 6 reference guides
• 1 Agent — board-analyst for deep board analysis
• 1 Hook — SessionStart context loader

See plugin/README.md for full details.

License

UNLICENSED