trello-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Pino logging level; stdio logs go to stderr. | info |
| TRELLO_TOKEN | Yes | Trello API token supplied by the operator. | |
| TRELLO_API_KEY | Yes | Trello API key supplied by the operator. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| auth_whoamiA | Use as a read-only credential diagnostic to confirm which Trello member the configured API key and token authenticate as. |
| auth_token_infoA | Use as a read-only credential diagnostic to inspect the configured Trello token's owner, expiration, and permissions; it does not create, refresh, revoke, or manage tokens. |
| list_boardsA | Use first when the user has not provided a board, list, card id, or Trello URL; returns boards visible to the authenticated Trello member. |
| board_createA | Use when creating a new Trello board. Creates boards as private by default, can place them in a workspace with workspaceId, and only supports explicit private, workspace, or public visibility. |
| board_getA | Use when you need board details, common board preferences, or label names for a known Trello board before listing or summarizing it. |
| board_field_getB | Use when you need one specific board field, such as prefs, labelNames, subscribed, name, description, or URL. |
| board_actionsA | Use when auditing recent activity or comments across a board; use filter, limit, page, since, before, and fields to keep large histories bounded. |
| board_listsA | Use when you need the lists on a known Trello board so you can find the right list id before listing or creating cards. |
| board_cardsB | Use when you need cards across all lists on a known Trello board for personal planning, review, or summarization. |
| board_custom_fieldsB | Use when inspecting custom field definitions on a known Trello board, including dropdown/list options when Trello returns them. |
| board_labelsB | Use when discovering labels available on a board before creating or updating cards with labels. |
| board_membersA | Use when you need the members who can access a known Trello board before assigning cards or reviewing collaboration; requires token visibility of private boards. |
| board_membershipsA | Use when you need board membership records, member roles, or permission context for a known Trello board; use the admins filter when checking board-admin-only operations. |
| list_workspacesA | Use first when the user asks to show Trello workspaces or needs to choose a workspace before drilling into its boards or members. |
| workspace_getA | Use when you need basic Trello workspace metadata, such as display name, description, URL, website, board ids, or preferences. |
| workspace_boardsC | Use when you need boards in a known Trello workspace so the user can drill into a workspace board. |
| workspace_membersA | Use when you need members in a known Trello workspace before assignment, auditing, or permission review. |
| workspace_actionsA | Use when auditing recent activity or comments across a Trello workspace; use filter, limit, page, since, before, and fields to keep large histories bounded. |
| member_getA | Use after member search or board member listing to inspect a Trello member profile by id, username, or me before assignment or auditing. |
| member_boardsA | Use when you need boards associated with a known Trello member by id, username, or me; results are limited to boards visible to the configured token. |
| member_cardsA | Use when you need cards assigned to a known Trello member by id, username, or me; private board cards require token access to those boards. |
| member_workspacesA | Use when you need Trello workspaces associated with a known member by id, username, or me; workspace visibility and role permissions constrain results. |
| list_getB | Use when you need metadata for a known Trello list before creating cards in it or changing it. |
| list_createB | Use when creating a new Trello list on an existing board. |
| list_updateB | Use when renaming a Trello list, changing its position, or setting its archive state. |
| list_archiveB | Use when archiving or unarchiving a Trello list while keeping its cards recoverable. |
| list_move_to_boardA | Move an existing list and its cards to another board, changing who can access them. Use list_update to reorder within the current board. |
| list_actionsA | Use when auditing recent activity or comments for a list; use filter, limit, page, since, before, and fields to keep large histories bounded. |
| card_getA | Use when you need the current details of one Trello card by id, short link, or URL before editing or summarizing it. |
| card_boardB | Use when you need the board relationship for a known Trello card before moving, labeling, or summarizing its context. |
| card_listA | Use when you need the current list relationship for a known Trello card before moving or reporting its status. |
| card_labelsA | Use when listing the labels currently applied to a card, including label ids for add/remove workflows. |
| list_cardsA | Use when you need cards in a specific Trello list; use limit, since, before, and fields to keep large lists small. |
| card_createA | Use when the user asks to create a new Trello card in a known list; accepts title, description, due date, members, and labels. |
| card_updateA | Use when changing card metadata such as title, description, due date, due completion, or archive state without moving it. |
| card_due_date_setA | Use when setting, clearing, or marking completion of a card due date without changing other card metadata. Provide at least one of due or dueComplete. |
| card_position_setA | Use when changing only a card's position within its current list; use card_move when changing lists or boards too. |
| card_cover_setA | Use when setting a card cover to an existing attachment id, changing cover display size, or clearing the current attachment cover. |
| card_label_create_and_addA | Create a new board label and apply it to this card. Use card_label_add for an existing label; repeating this creation can create duplicates. |
| card_deleteA | Use only when the user explicitly asks to permanently delete a Trello card; archive instead for reversible removal. |
| card_moveB | Use when moving a card to another list, another board, or a different position; this is distinct from general card metadata updates. |
| card_archiveA | Use when the user wants to archive or unarchive a card while keeping it recoverable; do not use for permanent deletion. |
| card_attachmentsA | Use when listing files or links attached to a card, optionally narrowed by Trello attachment fields or filter. |
| card_attachment_getA | Use when inspecting one existing card attachment by attachment id, including upload metadata when Trello returns it. |
| card_attachment_add_urlA | Use when attaching an existing public URL to a card; this does not upload local files. |
| card_attachment_uploadA | Read a server-local file inside TRELLO_ATTACHMENT_UPLOAD_ROOT and transmit its contents to Trello as a new card attachment. Disabled unless that root is configured; repeated uploads can create duplicates. Use card_attachment_add_url for public links. |
| card_attachment_deleteA | Permanently delete an attachment from a card, including Trello's stored file for uploads. This cannot be undone; use card_cover_set to clear a cover without deleting its attachment. |
| card_checklistsA | Use when viewing all checklists and checklist items currently on a card. |
| card_checklist_createB | Use when adding a new checklist to an existing card, optionally copied from another checklist. |
| card_checklist_updateA | Use when renaming a Trello card checklist or changing the checklist's position on its card. Provide at least one of name or pos. |
| card_checklist_deleteA | Permanently delete a checklist and all its items from a card. This cannot be undone; use card_checklist_item_delete to remove only one item. |
| card_checklist_item_createB | Use when adding a new item to an existing Trello checklist on a card. |
| card_checklist_itemsB | Use when listing the items in one Trello checklist, including complete and incomplete items by default. |
| card_checklist_item_updateB | Use when editing a Trello card checklist item text, due date, member assignment, completion state, checklist, or position. |
| card_checklist_item_set_checkedA | Use when checking or unchecking a Trello card checklist item without changing other item fields. |
| card_checklist_item_moveB | Use when moving a Trello checklist item to another checklist on the same card or to a different position. |
| card_checklist_item_deleteA | Permanently delete one checklist item. This cannot be undone; use card_checklist_item_set_checked to mark completion while keeping the item. |
| card_custom_field_itemsB | Use when reading all custom field item values currently set on a Trello card. |
| card_custom_field_setA | Set or replace one card custom field value, using the existing definition's type from custom_field_get. Use custom_field_options to find list option ids and card_custom_field_clear to remove a value. |
| card_custom_field_clearA | Clear one card's custom field value without deleting the board's field definition. Restoring it requires setting the previous value with card_custom_field_set. |
| card_membersA | Use when listing members assigned to a card; requires token access to the card's board. Use fields to keep member output small. |
| card_member_addA | Use when assigning a Trello member to a card by member id; requires write access to the card's board and a member who can be assigned to that board. |
| card_member_removeA | Use when unassigning a Trello member from a card by member id; requires write access to the card's board. |
| card_comment_addA | Add a new comment to a Trello card and return its comment action. Repeating the call creates another comment; use card_comment_update to edit an existing comment. |
| card_comment_updateA | Use when editing the text of an existing Trello card comment by its comment action id. |
| card_comment_deleteA | Permanently delete a card comment by its action id. This cannot be undone; use card_comment_update to edit the text instead. |
| card_actionsA | Use when auditing recent activity or comments for a card; use filter, limit, page, since, before, and fields to page large histories. |
| label_getA | Use when you need the current name, color, or board for a specific Trello label before editing it. |
| label_createB | Use when creating a new reusable label on a Trello board before applying it to cards. |
| label_updateA | Use when renaming a Trello label or changing its color without changing any card assignments. |
| label_deleteA | Use only when explicitly asked to permanently delete a board label, removing it from every card using it. Use card_label_remove to unassign it from just one card while preserving the label. |
| card_label_addB | Use when applying an existing Trello label to a card by label id. |
| card_label_removeB | Use when removing an existing Trello label from a card by label id. |
| custom_field_getA | Use when you need one Trello custom field definition by id, including its type and any dropdown/list options Trello returns. |
| custom_field_optionsA | Use when listing the available options for a Trello dropdown/list custom field before setting a card list custom field value. |
| searchA | Search Trello and return grouped cards, boards, members, and workspaces visible to the token. Defaults to cards and boards; scope and limit results, and use cardsPage for card pagination. Use search_members for a focused member lookup. |
| search_membersA | Use when looking up Trello members by name or username, optionally scoped to a board or workspace; scoped searches require token access to that board or workspace. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 77 tools
Descriptions work hard to draw boundaries (card_archive vs card_delete, card_move vs card_position_set, card_label_add vs card_label_create_and_add, and the four *_actions tools scoped by resource). However, real overlaps remain: card_update explicitly covers due dates and archive state that card_due_date_set and card_archive also handle, and card_checklist_item_update claims completion state, checklist, and position — all owned by card_checklist_item_set_checked and card_checklist_item_move.
The dominant pattern is <resource>_<action> (board_get, card_create, label_delete), which is readable and mostly followed. But the `list_` prefix is overloaded: list_boards/list_workspaces mean 'enumerate', while list_get/list_update/list_archive mean 'the list resource' — and card_list vs list_cards are near-identical names with opposite meanings. That collision is a genuine trap for an agent.
77 tools is far beyond a reasonable surface and the granularity is excessive: board_get vs board_field_get, card_list vs card_board vs card_get, and separate tools for due date, position, cover, and archive on a card. While Trello is a large domain, many tools could be folded into a single card_update or board_get variant.
Coverage is broad and deep: full card lifecycle (create/update/move/archive/delete), checklists, labels, attachments, custom field values, members, workspaces, actions, and search. Gaps remain — no board update/archive/delete, no custom field definition create/update/delete (only get/options), and no board member add/remove, so board-level mutation is a dead end.