MCP tools

All 39 stdio tools (36 over HTTP OAuth) — account, workplaces, the board, cards, checklists, comments, tags, and invitations.

The stdio server exposes 39 tools. The HTTP OAuth endpoint exposes 36: login,
register_account, and logout are omitted because the access token identifies the user. Most
tools accept an optional workplaceId; omit it when you belong to one workplace, or set
KANBAN_WORKPLACE_ID.

Tool names are stable. Column tools accept a column name as an alternative to a UUID, tag tools
accept tag names, and assignee tools accept usernames, so the model rarely needs to handle IDs by
hand.

Account

ToolWhat it does
whoamiSigned-in user plus every workplace (id, name, role)
loginSign in with username/email and password; caches the session
register_accountCreate an account and its default workplace
logoutDiscard the cached session

register_account enforces the same rules as the web form: lowercase usernames without spaces or
reserved names, and a password with mixed case, a number, and a symbol that is not common or
account-derived. Validation errors come back per field.

Workplaces and members

ToolWhat it doesAccess
list_workplacesWorkplaces you belong tomember
create_workplaceNew workplace with the four default columnsany
rename_workplaceRename a workplaceowner
list_membersMembers with user IDs, roles, join dates, and owner-visible emailsmember
remove_memberRemove a member and clear their card assignmentsowner
leave_workplaceLeave a workplacemember

Board and columns

ToolWhat it doesAccess
get_boardColumns, cards, tags, and your role — the main ID discovery toolmember
find_cardsSearch by title substring, column, tag, or assigneemember
create_columnAdd a column at the endowner
update_columnRename or hide/show a columnowner
delete_columnDelete a column; its cards move to the first visible columnowner
reorder_columnsSet the left-to-right order; every column ID must appear onceowner

Cards

ToolWhat it does
create_cardCreate a card by columnId or columnName (defaults to the first visible column)
get_cardFull detail: description, tags, assignees, checklists, comments
update_cardChange title or description; description: null clears it
move_cardMove to a column and 0-based position; omit position to append
delete_cardPermanently delete the card and its children
set_card_tagsReplace tags by name or ID; empty arrays clear them
set_card_assigneesReplace assignees by username or user ID; empty arrays unassign

All card tools are available to any workplace member.

Checklists and comments

ToolWhat it does
add_subtaskAppend a checklist item to a card
update_subtaskRename an item or toggle isDone
delete_subtaskDelete a checklist item
add_commentComment on a card as the signed-in user
update_commentEdit one of your own comments
delete_commentDelete your comment; owners can delete any comment

Tags

ToolWhat it doesAccess
list_tagsTags in a workplace with IDs and colorsmember
create_tagCreate a tag; the color defaults to the next palette colormember
update_tagRename or recolor a tagowner
delete_tagDelete a tag everywhere it is usedowner

Colors must come from the app palette: #d1495b, #e07a5f, #e9c46a, #2a9d8f, #457b9d,
#6d597a, #7a9e7e, #5e60ce.

Invitations

ToolWhat it doesAccess
list_my_invitationsPending invitations addressed to youany
list_workplace_invitationsPending invitations sent by a workplaceowner
invite_memberInvite a registered user by exact username or emailowner
accept_invitationAccept one of your invitationsany
decline_invitationDecline one of your invitationsany
cancel_invitationCancel a pending invitationowner

Common patterns

GoalTools
Find a cardfind_cards then get_card
Create work in a specific lanecreate_card with columnName
Move a card to the end of Donemove_card with columnName: "Done"
Break a card into stepsadd_subtask, then update_subtask with isDone
Tag and assign in one passset_card_tags and set_card_assignees
Add a collaboratorinvite_member; they call accept_invitation

Destructive tools

delete_card, delete_column, delete_tag, delete_subtask, delete_comment, remove_member,
leave_workplace, decline_invitation, and cancel_invitation permanently change data. Tool
descriptions tell the model to confirm with the user first, but review what your client is allowed
to auto-approve.


Did this page help you?