Kanban Studio MCP

Supported tools

Learn what your AI agent can do with Kanban Studio MCP tools.

MCP tools

Tools are grouped by read and write operations. Scope enables the operation, and board/workspace role authorization still applies.

Each tool has two security checks: scope-based permission from your OAuth/API credential, and role-based authorization from your Kanban Studio membership. A valid scope alone is never enough if your user cannot access the target board.

Use these specs as an implementation contract for prompts and automations. When a call fails, inspect both scope and board role first. Most FORBIDDEN errors are caused by one of those two conditions.

For production agents, start with read-only scopes and expand only when needed. This keeps blast radius low and reduces accidental board changes during prompt iteration.

Bulk write tools execute item by item, return partial success reports, and support per-item clientRequestId idempotency for safe retries. Keep batches small and deterministic.

Read tools

Read tools for Kanban Studio MCP with scopes, arguments, and authorization notes
Tool	Scope	Purpose	Arguments	Authorization
list_boards	boards:read	List boards available to the API key owner.		Requires board access for each returned board.
get_board	boards:read	Get board details by boardId.	boardId: string	Requires viewer role or higher on target board.
list_lists	boards:read	List all lists in a board.	boardId: string	Requires viewer role or higher on target board.
list_cards	cards:read	List cards in a board with optional limit.	boardId: string limit?: number	Requires viewer role or higher on target board.
get_card	cards:read	Get full card details by cardId.	cardId: string	Requires viewer role or higher on card board.
list_checklist_items	cards:read	List checklist items and progress metrics for a card.	cardId: string	Requires viewer role or higher on card board.

Write tools

Write tools for Kanban Studio MCP with scopes, arguments, and authorization notes
Tool	Scope	Purpose	Arguments	Authorization
create_list	boards:write	Create a list in a board.	boardId: string title: string isDoneList?: boolean	Requires editor role or higher on target board.
move_list	boards:write	Move a list to a target index inside the same board.	boardId: string listId: string targetIndex: number	Requires editor role or higher on target board.
create_card	cards:write	Create a card in a target list.	boardId: string listId: string title: string description?: string recurrence?: { frequency: 'daily' \| 'weekly' \| 'monthly'; hour: number; dayOfWeek?: number; dayOfMonth?: number; targetListId?: string; timezone: string }	Requires editor role or higher on target board.
update_card	cards:write	Update card fields and status.	cardId: string title?: string description?: string listId?: string done?: boolean recurrence?: { frequency: 'daily' \| 'weekly' \| 'monthly'; hour: number; dayOfWeek?: number; dayOfMonth?: number; targetListId?: string; timezone: string } \| null	Requires editor role or higher on card board.
move_card	cards:write	Move card to another list in the same board.	cardId: string listId: string order?: number	Requires editor role or higher on card board.
archive_card	cards:write	Archive a completed card.	cardId: string	Requires editor role or higher on card board.
add_comment	comments:write	Add a comment to a card.	cardId: string text: string	Requires editor role or higher on card board.
add_checklist_item	cards:write	Add a checklist item to a card.	cardId: string text: string index?: number	Requires editor role or higher on card board.
update_checklist_item	cards:write	Update checklist item text by index.	cardId: string index: number text: string	Requires editor role or higher on card board.
set_checklist_item_checked	cards:write	Mark a checklist item as done or pending by index.	cardId: string index: number checked: boolean	Requires editor role or higher on card board.
remove_checklist_item	cards:write	Remove a checklist item by index.	cardId: string index: number	Requires editor role or higher on card board.
clear_checklist	cards:write	Remove all checklist items from a card.	cardId: string	Requires editor role or higher on card board.
bulk_create_cards	cards:write	Create multiple cards with per-item success and error reporting.	boardId: string defaultListId?: string items: Array<{ clientRequestId?: string; listId?: string; title: string; description?: string }>	Requires editor role or higher on the target board. Each item must resolve to a list in the same board.
bulk_update_cards	cards:write	Update, comment, and archive multiple cards with partial success handling.	boardId?: string items: Array<{ clientRequestId?: string; cardId: string; listId?: string; done?: boolean; recurrence?: { frequency: 'daily' \| 'weekly' \| 'monthly'; hour: number; dayOfWeek?: number; dayOfMonth?: number; targetListId?: string; timezone: string } \| null; startDate?: number \| null; dueDate?: number \| null; archiveIfDone?: boolean; comment?: string }>	Requires editor role or higher on each target card board. Optional boardId narrows the batch to one board.