# Kanban Tool — how to use (mcp.ai)

Connect your Kanban Tool account and use 11 tools for project management straight from your AI agent. Connect with your own API key. Kanban Tool is a visual project and task management platform for organizing boards, workflows, tasks, collaboration, and time tracking.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kanban_tool?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kanban_tool_add_comment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kanban_tool`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kanban_tool/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kanban_tool/add/comment` — Add a text comment to a task.
  - body: { content: string, task_id: integer }
- `POST https://api.mcp.ai/api/kanban_tool/change/task/lifecycle` — Archive, unarchive, soft-delete, or restore a task. Treat this as destructive because soft-delete hides the task from active workflows, although restore can reverse it.
  - body: { action: string, task_id: integer }
- `POST https://api.mcp.ai/api/kanban_tool/create/subtask` — Create a subtask under an existing task or create it unattached for later use, with optional assignment and completion state.
  - body: { name: string, task_id?: integer, is_completed?: boolean, assigned_user_id?: integer }
- `POST https://api.mcp.ai/api/kanban_tool/create/task` — Create a task on a board with optional workflow placement, assignment, estimates, due dates, tags, external references, and previously created unattached subtasks.
  - body: { name: string, tags?: string[], board_id: integer, due_date?: string, position?: integer, priority?: integer, description?: string, external_id?: integer|string, subtask_ids?: integer[], swimlane_id?: integer, card_type_id?: integer, external_link?: string, size_estimate?: number, time_estimate?: number, postponed_until?: string, assigned_user_id?: integer, workflow_stage_id?: integer, recurring_schedule?: string, assert_has_unique_external_id?: boolean }
- `POST https://api.mcp.ai/api/kanban_tool/delete/subtask` — Soft-delete a subtask and return its tombstone.
  - body: { subtask_id: integer }
- `POST https://api.mcp.ai/api/kanban_tool/get/board` — Fetch a board's workflow configuration and collaborators without loading its full active task collection.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/kanban_tool/get/task` — Fetch a task with its comments, subtasks, attachments, changelog, dependencies, and time trackers. A deleted task is returned as a tombstone with deleted_at set.
  - body: { task_id: integer }
- `POST https://api.mcp.ai/api/kanban_tool/list/boards` — List boards available to the connected Kanban Tool user, including each board's permissions and account feature/tier context.
- `POST https://api.mcp.ai/api/kanban_tool/search/tasks` — Search visible tasks with Kanban Tool query syntax and return one page plus a continuation cursor. Supports board filtering and archived tasks.
  - body: { limit?: integer, query?: string, cursor?: string, board_ids?: integer[], include_archived?: boolean }
- `POST https://api.mcp.ai/api/kanban_tool/update/subtask` — Update a subtask's name, assignee, or completion state.
  - body: { name?: string, subtask_id: integer, is_completed?: boolean, assigned_user_id?: integer }
- `POST https://api.mcp.ai/api/kanban_tool/update/task` — Update a task's content, placement, assignment, estimates, dates, tags, or external references. Use CHANGE_TASK_LIFECYCLE to archive, delete, or restore it.
  - body: { name?: string, tags?: string[], task_id: integer, board_id?: integer, due_date?: string, position?: integer, priority?: integer, description?: string, external_id?: integer|string, swimlane_id?: integer, card_type_id?: integer, external_link?: string, size_estimate?: number, time_estimate?: number, postponed_until?: string, assigned_user_id?: integer, workflow_stage_id?: integer, recurring_schedule?: string }

## Example prompts
- "What can I do in Kanban Tool?"
- "Show me a summary of my Kanban Tool account"

## More
- Page: https://mcp.ai/kanban_tool
- Agent spec (llms.txt): https://mcp.ai/kanban_tool/llms.txt
- Postman collection: https://mcp.ai/kanban_tool/postman.json