Skip to content
trello-mcp

Tool catalog

The server exposes 77 tools across 13 focused areas. Names, descriptions, and input definitions come directly from the same allTools entries and Zod schemas used by the server. Category, behavior, scope, and result labels are curated for this reference and checked to cover every registered tool exactly once.

“Read only” means the tool does not intentionally change Trello. “Writes data” covers creates, updates, assignments, moves, and reversible state changes. “Permanent delete” identifies calls that remove a Trello resource rather than archive or detach it. Tool handlers return JSON-serializable data to the MCP client.

Search by tool name, purpose, result, or input, or narrow the catalog by category and behavior. Every tool has a direct link. Example prompts use placeholder names and contain no credentials or account data.

Credential diagnostics

Confirm the configured account and inspect token metadata before doing real work.

Example prompt: “Tell me which Trello account this server uses and show the token permissions. Do not make changes.”

2 tools

  • auth_whoami

    Read only

    Use as a read-only credential diagnostic to confirm which Trello member the configured API key and token authenticate as.

    Inputs1 optional
    fieldsOptional
    Comma-separated Trello authenticated member fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    authenticated member object

  • auth_token_info

    Read only

    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.

    Inputs1 optional
    fieldsOptional
    Comma-separated Trello configured token fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    configured token metadata

Boards

Discover boards and inspect their lists, cards, fields, labels, members, and recent activity.

Example prompt: “List the boards I can access, then show the open lists on the board I choose. Do not make changes.”

11 tools

  • list_boards

    Read only

    Use first when the user has not provided a board, list, card id, or Trello URL; returns boards visible to the authenticated Trello member.

    Inputs2 optional
    filterOptional
    Which boards to include for the current Trello member.
    fieldsOptional
    Comma-separated Trello board fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    board array

  • board_create

    Writes data

    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.

    Inputs1 required, 3 optional
    nameRequired
    Name for the new Trello board.
    descOptional
    Optional board description.
    workspaceIdOptional
    Optional Trello workspace/organization id where the board should be created.
    permissionLevelOptional
    Board visibility to request. Defaults to private; use org only with a workspace id and public only when intentional.
    Scope
    single Trello mutation
    Result
    created board object

  • board_get

    Read only

    Use when you need board details, common board preferences, or label names for a known Trello board before listing or summarizing it.

    Inputs1 required, 1 optional
    boardIdRequired
    Trello board id to inspect.
    fieldsOptional
    Comma-separated Trello board fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    board object

  • board_field_get

    Read only

    Use when you need one specific board field, such as prefs, labelNames, subscribed, name, description, or URL.

    Inputs2 required
    boardIdRequired
    Trello board id to inspect.
    fieldRequired
    Single board field to read. Use prefs for common board preferences and labelNames for board label names.
    Scope
    single resource or visible collection
    Result
    selected board field

  • board_actions

    Read only

    Use when auditing recent activity or comments across a board; use filter, limit, page, since, before, and fields to keep large histories bounded.

    Inputs1 required, 10 optional
    boardIdRequired
    Trello board id to inspect.
    filterOptional
    Trello action filter such as all or commentCard.
    fieldsOptional
    Comma-separated Trello action fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    sinceOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    beforeOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    pageOptional
    Zero-based result page for Trello action collections.
    memberOptional
    Whether to include member objects on actions.
    memberFieldsOptional
    Comma-separated Trello member fields when member is true.
    memberCreatorOptional
    Whether to include the memberCreator object on actions.
    memberCreatorFieldsOptional
    Comma-separated Trello memberCreator fields when memberCreator is true.
    Scope
    caller-bounded collection
    Result
    action array

  • board_lists

    Read only

    Use when you need the lists on a known Trello board so you can find the right list id before listing or creating cards.

    Inputs1 required, 2 optional
    boardIdRequired
    Trello board id to inspect.
    filterOptional
    Which lists to include from the board.
    fieldsOptional
    Comma-separated Trello list fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    list array

  • board_cards

    Read only

    Use when you need cards across all lists on a known Trello board for personal planning, review, or summarization.

    Inputs1 required, 5 optional
    boardIdRequired
    Trello board id to inspect.
    filterOptional
    Which cards to include from the board.
    fieldsOptional
    Comma-separated Trello card fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    sinceOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    beforeOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    Scope
    caller-bounded collection
    Result
    card array

  • board_custom_fields

    Read only

    Use when inspecting custom field definitions on a known Trello board, including dropdown/list options when Trello returns them.

    Inputs1 required
    boardIdRequired
    Trello board id to inspect.
    Scope
    single resource or visible collection
    Result
    custom field array

  • board_labels

    Read only

    Use when discovering labels available on a board before creating or updating cards with labels.

    Inputs1 required, 2 optional
    boardIdRequired
    Trello board id to inspect.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    fieldsOptional
    Comma-separated Trello label fields to request; use all for detailed follow-up reads.
    Scope
    caller-bounded collection
    Result
    label array

  • board_members

    Read only

    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.

    Inputs1 required, 1 optional
    boardIdRequired
    Trello board id to inspect.
    fieldsOptional
    Comma-separated Trello member fields to request; use all for detailed follow-up reads.
    Scope
    single resource or visible collection
    Result
    member array

  • board_memberships

    Read only

    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.

    Inputs1 required, 3 optional
    boardIdRequired
    Trello board id to inspect.
    filterOptional
    Which board memberships to include.
    memberOptional
    Whether to include basic member profile details.
    memberFieldsOptional
    Comma-separated Trello member fields when member is true.
    Scope
    single resource or visible collection
    Result
    membership array

Workspaces

Find Trello workspaces and inspect their metadata, boards, members, and activity.

Example prompt: “List my Trello workspaces and summarize the boards in the workspace I choose. Do not make changes.”

5 tools

  • list_workspaces

    Read only

    Use first when the user asks to show Trello workspaces or needs to choose a workspace before drilling into its boards or members.

    Inputs3 optional
    filterOptional
    Which Trello workspaces to include for the current member.
    fieldsOptional
    Comma-separated Trello workspace fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    paidAccountOptional
    Whether to include Trello paid account details when available.
    Scope
    single resource or visible collection
    Result
    workspace array

  • workspace_get

    Read only

    Use when you need basic Trello workspace metadata, such as display name, description, URL, website, board ids, or preferences.

    Inputs1 required, 1 optional
    workspaceIdRequired
    Trello workspace id or short name.
    fieldsOptional
    Comma-separated Trello workspace fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    workspace object

  • workspace_boards

    Read only

    Use when you need boards in a known Trello workspace so the user can drill into a workspace board.

    Inputs1 required, 2 optional
    workspaceIdRequired
    Trello workspace id or short name.
    filterOptional
    Which boards to include from the workspace.
    fieldsOptional
    Comma-separated Trello board fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    board array

  • workspace_members

    Read only

    Use when you need members in a known Trello workspace before assignment, auditing, or permission review.

    Inputs1 required, 2 optional
    workspaceIdRequired
    Trello workspace id or short name.
    filterOptional
    Which workspace members to include.
    fieldsOptional
    Comma-separated Trello workspace member fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    member array

  • workspace_actions

    Read only

    Use when auditing recent activity or comments across a Trello workspace; use filter, limit, page, since, before, and fields to keep large histories bounded.

    Inputs1 required, 10 optional
    workspaceIdRequired
    Trello workspace id or short name.
    filterOptional
    Trello action filter such as all or commentCard.
    fieldsOptional
    Comma-separated Trello action fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    sinceOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    beforeOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    pageOptional
    Zero-based result page for Trello action collections.
    memberOptional
    Whether to include member objects on actions.
    memberFieldsOptional
    Comma-separated Trello member fields when member is true.
    memberCreatorOptional
    Whether to include the memberCreator object on actions.
    memberCreatorFieldsOptional
    Comma-separated Trello memberCreator fields when memberCreator is true.
    Scope
    caller-bounded collection
    Result
    action array

Members

Inspect Trello member profiles and the boards, cards, and workspaces visible for them.

Example prompt: “Using this Trello member username or id, list the cards assigned to that member. Do not make changes.”

4 tools

  • member_get

    Read only

    Use after member search or board member listing to inspect a Trello member profile by id, username, or me before assignment or auditing.

    Inputs1 required, 1 optional
    memberIdRequired
    Trello member id, username, or me.
    fieldsOptional
    Comma-separated Trello member profile fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    member object

  • member_boards

    Read only

    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.

    Inputs1 required, 2 optional
    memberIdRequired
    Trello member id, username, or me.
    filterOptional
    Which boards to include for the member.
    fieldsOptional
    Comma-separated Trello board fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    board array

  • member_cards

    Read only

    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.

    Inputs1 required, 5 optional
    memberIdRequired
    Trello member id, username, or me.
    filterOptional
    Which cards assigned to the member to include.
    fieldsOptional
    Comma-separated Trello card fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    sinceOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    beforeOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    Scope
    caller-bounded collection
    Result
    card array

  • member_workspaces

    Read only

    Use when you need Trello workspaces associated with a known member by id, username, or me; workspace visibility and role permissions constrain results.

    Inputs1 required, 3 optional
    memberIdRequired
    Trello member id, username, or me.
    filterOptional
    Which Trello workspaces to include for the member.
    fieldsOptional
    Comma-separated Trello workspace fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    paidAccountOptional
    Whether to include Trello paid account details when available.
    Scope
    single resource or visible collection
    Result
    workspace array

Lists

Inspect, create, rename, move, archive, and review cards or activity within lists.

Example prompt: “Show the cards in the Doing list, ordered as Trello returns them. Do not make changes.”

7 tools

  • list_get

    Read only

    Use when you need metadata for a known Trello list before creating cards in it or changing it.

    Inputs1 required, 1 optional
    listIdRequired
    Trello list id to read or update.
    fieldsOptional
    Comma-separated Trello list fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    list object

  • list_create

    Writes data

    Use when creating a new Trello list on an existing board.

    Inputs2 required, 1 optional
    boardIdRequired
    Board id where the new Trello list should be created.
    nameRequired
    Human-readable list name.
    posOptional
    Position for the list on its board.
    Scope
    single Trello mutation
    Result
    created list object

  • list_update

    Writes data

    Use when renaming a Trello list, changing its position, or setting its archive state.

    Inputs1 required, 3 optional
    listIdRequired
    Trello list id to read or update.
    nameOptional
    New list name.
    closedOptional
    Set true to archive the list; false to unarchive it.
    posOptional
    Position for the list on its board.
    Scope
    single Trello mutation
    Result
    updated list object

  • list_archive

    Writes data

    Use when archiving or unarchiving a Trello list while keeping its cards recoverable.

    Inputs1 required, 1 optional
    listIdRequired
    Trello list id to read or update.
    closedOptional
    True archives the list; false restores it.
    Scope
    single Trello mutation
    Result
    updated list object

  • list_move_to_board

    Writes data

    Use when moving an existing Trello list to another board.

    Inputs2 required
    listIdRequired
    Trello list id to read or update.
    boardIdRequired
    Destination board id.
    Scope
    single Trello mutation
    Result
    moved list object

  • list_actions

    Read only

    Use when auditing recent activity or comments for a list; use filter, limit, page, since, before, and fields to keep large histories bounded.

    Inputs1 required, 10 optional
    listIdRequired
    Trello list id to read or update.
    filterOptional
    Trello action filter such as all or commentCard.
    fieldsOptional
    Comma-separated Trello action fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    sinceOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    beforeOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    pageOptional
    Zero-based result page for Trello action collections.
    memberOptional
    Whether to include member objects on actions.
    memberFieldsOptional
    Comma-separated Trello member fields when member is true.
    memberCreatorOptional
    Whether to include the memberCreator object on actions.
    memberCreatorFieldsOptional
    Comma-separated Trello memberCreator fields when memberCreator is true.
    Scope
    caller-bounded collection
    Result
    action array

  • list_cards

    Read only

    Use when you need cards in a specific Trello list; use limit, since, before, and fields to keep large lists small.

    Inputs1 required, 5 optional
    listIdRequired
    Trello list id to read cards from.
    filterOptional
    Which cards to include from the list.
    fieldsOptional
    Comma-separated Trello card fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    sinceOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    beforeOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    Scope
    caller-bounded collection
    Result
    card array

Cards

Read, create, update, move, archive, cover, label, or permanently delete individual cards.

Example prompt: “Show me the current details of this card and its board and list. Do not make changes.”

12 tools

  • card_get

    Read only

    Use when you need the current details of one Trello card by id, short id, or URL before editing or summarizing it.

    Inputs1 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    fieldsOptional
    Comma-separated Trello card fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    card object

  • card_board

    Read only

    Use when you need the board relationship for a known Trello card before moving, labeling, or summarizing its context.

    Inputs1 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    fieldsOptional
    Comma-separated Trello related resource fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    board object

  • card_list

    Read only

    Use when you need the current list relationship for a known Trello card before moving or reporting its status.

    Inputs1 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    fieldsOptional
    Comma-separated Trello related resource fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    list object

  • card_create

    Writes data

    Use when the user asks to create a new Trello card in a known list; accepts title, description, due date, members, and labels.

    Inputs2 required, 5 optional
    listIdRequired
    Destination list id where the new card should be created.
    nameRequired
    Human-readable card title.
    descOptional
    Optional card description.
    dueOptional
    Optional ISO-8601 due date.
    posOptional
    Position in the destination list.
    memberIdsOptional
    Optional member ids to assign when creating the card.
    labelIdsOptional
    Optional label ids to apply when creating the card.
    Scope
    single Trello mutation
    Result
    created card object

  • card_update

    Writes data

    Use when changing card metadata such as title, description, due date, due completion, or archive state without moving it.

    Inputs1 required, 5 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    nameOptional
    New card title.
    descOptional
    New card description.
    dueOptional
    New ISO-8601 due date, or null to clear it.
    dueCompleteOptional
    Whether the due date is complete.
    closedOptional
    Set true to archive the card; false to unarchive it.
    Scope
    single Trello mutation
    Result
    updated card object

  • card_due_date_set

    Writes data

    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.

    Inputs1 required, 2 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    dueOptional
    ISO-8601 due date to set, or null to clear the card due date.
    dueCompleteOptional
    Whether the due date should be marked complete.
    Scope
    single Trello mutation
    Result
    updated card object

  • card_position_set

    Writes data

    Use when changing only a card's position within its current list; use card_move when changing lists or boards too.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    posRequired
    New position for the card within its current or destination list.
    Scope
    single Trello mutation
    Result
    updated card object

  • card_cover_set

    Writes data

    Use when setting a card cover to an existing attachment id, changing cover display size, or clearing the current attachment cover.

    Inputs2 required, 2 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    attachmentIdRequired
    Attachment id to use as the card cover, or null to clear the attachment cover.
    sizeOptional
    Trello cover display size: normal for the regular half cover, or full for an integrated full cover. Requires attachmentId.
    brightnessOptional
    Text contrast for full covers: light or dark. Requires attachmentId.
    Scope
    single Trello mutation
    Result
    updated card object

  • card_label_create_and_add

    Writes data

    Use when creating a new label on the card's board and applying it to the card in one Trello operation.

    Inputs3 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    nameRequired
    Human-readable label name.
    colorRequired
    Trello label color for the new board label to create and apply.
    Scope
    single Trello mutation
    Result
    created label object

  • card_delete

    Writes dataPermanent delete

    Use only when the user explicitly asks to permanently delete a Trello card; archive instead for reversible removal.

    Inputs1 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    Scope
    single permanent deletion
    Result
    validated deletion response

  • card_move

    Writes data

    Use when moving a card to another list, another board, or a different position; this is distinct from general card metadata updates.

    Inputs1 required, 3 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    listIdOptional
    Destination list id. Required when moving to another list.
    boardIdOptional
    Destination board id. Include when moving across boards.
    posOptional
    Position in the destination list.
    Scope
    single Trello mutation
    Result
    moved card object

  • card_archive

    Writes data

    Use when the user wants to archive or unarchive a card while keeping it recoverable; do not use for permanent deletion.

    Inputs1 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    closedOptional
    True archives the card; false restores it.
    Scope
    single Trello mutation
    Result
    updated card object

Attachments

Inspect card attachments, add public URLs, upload allowed local files, or remove attachments.

Example prompt: “List the attachments on this card and include their names and URLs. Do not make changes.”

5 tools

  • card_attachments

    Read only

    Use when listing files or links attached to a card, optionally narrowed by Trello attachment fields or filter.

    Inputs1 required, 2 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    fieldsOptional
    Comma-separated Trello attachment fields to request; use all for detailed follow-up reads.
    filterOptional
    Optional Trello attachment filter, such as cover.
    Scope
    single resource or visible collection
    Result
    attachment array

  • card_attachment_get

    Read only

    Use when inspecting one existing card attachment by attachment id, including upload metadata when Trello returns it.

    Inputs2 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    fieldsOptional
    Comma-separated Trello attachment fields to request; use all for detailed follow-up reads.
    attachmentIdRequired
    Attachment id to inspect.
    Scope
    single resource or visible collection
    Result
    attachment object

  • card_attachment_add_url

    Writes data

    Use when attaching an existing public URL to a card; this does not upload local files.

    Inputs2 required, 2 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    urlRequired
    Public URL to attach to the card.
    nameOptional
    Optional display name for the attachment.
    setCoverOptional
    Whether Trello should make this URL attachment the card cover.
    Scope
    single Trello mutation
    Result
    created attachment object

  • card_attachment_upload

    Writes data

    Use when uploading a server-local file to a card. Requires TRELLO_ATTACHMENT_UPLOAD_ROOT and only reads files inside that directory.

    Inputs2 required, 3 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    filePathRequired
    Server-side file path to upload. Relative paths resolve inside TRELLO_ATTACHMENT_UPLOAD_ROOT; absolute paths must also be inside that root.
    nameOptional
    Optional Trello display name for the uploaded attachment.
    mimeTypeOptional
    Optional MIME type to send for the uploaded file.
    setCoverOptional
    Whether Trello should make this uploaded attachment the cover.
    Scope
    single Trello mutation
    Result
    uploaded attachment object

  • card_attachment_delete

    Writes dataPermanent delete

    Use when removing a specific attachment from a card by attachment id.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    attachmentIdRequired
    Attachment id to remove from the card.
    Scope
    single permanent deletion
    Result
    validated deletion response

Checklists

Manage card checklists and checklist items, including text, state, ownership, dates, and position.

Example prompt: “Show every checklist and incomplete checklist item on this card. Do not make changes.”

10 tools

  • card_checklists

    Read only

    Use when viewing all checklists and checklist items currently on a card.

    Inputs1 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    Scope
    single resource or visible collection
    Result
    checklist array

  • card_checklist_create

    Writes data

    Use when adding a new checklist to an existing card, optionally copied from another checklist.

    Inputs2 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    nameRequired
    Checklist name.
    sourceChecklistIdOptional
    Existing checklist id to copy items from.
    Scope
    single Trello mutation
    Result
    created checklist object

  • card_checklist_update

    Writes data

    Use when renaming a Trello card checklist or changing the checklist's position on its card. Provide at least one of name or pos.

    Inputs1 required, 2 optional
    checklistIdRequired
    Trello checklist id.
    nameOptional
    Updated checklist name.
    posOptional
    New position for the checklist on its card.
    Scope
    single Trello mutation
    Result
    updated checklist object

  • card_checklist_delete

    Writes dataPermanent delete

    Use when deleting an entire checklist from a Trello card.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    checklistIdRequired
    Trello checklist id.
    Scope
    single permanent deletion
    Result
    validated deletion response

  • card_checklist_item_create

    Writes data

    Use when adding a new item to an existing Trello checklist on a card.

    Inputs2 required, 5 optional
    checklistIdRequired
    Trello checklist id.
    nameRequired
    Checklist item text.
    posOptional
    Position of the checklist item within its checklist.
    checkedOptional
    Whether the checklist item should start checked.
    dueOptional
    Optional ISO-8601 due date for the checklist item.
    dueReminderOptional
    Optional reminder offset in minutes for the item due date.
    memberIdOptional
    Optional Trello member id assigned to the checklist item.
    Scope
    single Trello mutation
    Result
    created checklist item object

  • card_checklist_items

    Read only

    Use when listing the items in one Trello checklist, including complete and incomplete items by default.

    Inputs1 required, 2 optional
    checklistIdRequired
    Trello checklist id.
    filterOptional
    Which checklist items to include.
    fieldsOptional
    Comma-separated Trello checklist item fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    Scope
    single resource or visible collection
    Result
    checklist item array

  • card_checklist_item_update

    Writes data

    Use when editing a Trello card checklist item text, due date, member assignment, completion state, checklist, or position.

    Inputs2 required, 7 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    checkItemIdRequired
    Trello checklist item id.
    nameOptional
    Updated checklist item text.
    stateOptional
    Set to complete to check the item or incomplete to uncheck it.
    checklistIdOptional
    Destination checklist id; include to move the item to another checklist on the card.
    posOptional
    Position of the checklist item within its checklist.
    dueOptional
    New ISO-8601 item due date, or null to clear it.
    dueReminderOptional
    New reminder offset in minutes, or null to clear it.
    memberIdOptional
    Trello member id assigned to the item, or null to unassign.
    Scope
    single Trello mutation
    Result
    updated checklist item object

  • card_checklist_item_set_checked

    Writes data

    Use when checking or unchecking a Trello card checklist item without changing other item fields.

    Inputs3 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    checkItemIdRequired
    Trello checklist item id.
    checkedRequired
    True checks the item; false unchecks it.
    Scope
    single Trello mutation
    Result
    updated checklist item object

  • card_checklist_item_move

    Writes data

    Use when moving a Trello checklist item to another checklist on the same card or to a different position.

    Inputs3 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    checkItemIdRequired
    Trello checklist item id.
    checklistIdRequired
    Destination checklist id on the card.
    posOptional
    Position of the checklist item within its checklist.
    Scope
    single Trello mutation
    Result
    moved checklist item object

  • card_checklist_item_delete

    Writes dataPermanent delete

    Use when deleting a checklist item from a Trello card checklist.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    checkItemIdRequired
    Trello checklist item id.
    Scope
    single permanent deletion
    Result
    validated deletion response

Custom fields

Inspect custom field definitions and options, then read, set, or clear card values.

Example prompt: “Using this custom field id, show its definition and options, then show the custom field values on this card. Do not make changes.”

5 tools

  • card_custom_field_items

    Read only

    Use when reading all custom field item values currently set on a Trello card.

    Inputs1 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    Scope
    single resource or visible collection
    Result
    custom field item array

  • card_custom_field_set

    Writes data

    Use when setting or updating one Trello card custom field value. Use type-specific inputs: text, number string, ISO date, checkbox boolean, or list optionId.

    Inputs3 required, 5 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    customFieldIdRequired
    Trello custom field definition id.
    typeRequired
    Custom field type for the value being set.
    textOptional
    Text value for text custom fields.
    numberOptional
    Number value for number custom fields; Trello expects a string.
    dateOptional
    ISO-8601 date/time value for date custom fields.
    checkedOptional
    Boolean value for checkbox fields.
    optionIdOptional
    Dropdown/list custom field option id for list fields.
    Scope
    single Trello mutation
    Result
    custom field item result

  • card_custom_field_clear

    Writes data

    Use when clearing one Trello card custom field value; Trello clears custom field items with an empty PUT body shape rather than DELETE.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    customFieldIdRequired
    Trello custom field definition id.
    Scope
    single Trello mutation
    Result
    custom field clear result

  • custom_field_get

    Read only

    Use when you need one Trello custom field definition by id, including its type and any dropdown/list options Trello returns.

    Inputs1 required
    customFieldIdRequired
    Trello custom field definition id.
    Scope
    single resource or visible collection
    Result
    custom field object

  • custom_field_options

    Read only

    Use when listing the available options for a Trello dropdown/list custom field before setting a card list custom field value.

    Inputs1 required
    customFieldIdRequired
    Trello custom field definition id.
    Scope
    single resource or visible collection
    Result
    custom field option array

Card members

Review card assignments and explicitly assign or unassign Trello members.

Example prompt: “List the members assigned to this card and show their usernames. Do not make changes.”

3 tools

  • card_members

    Read only

    Use when listing members assigned to a card; requires token access to the card's board. Use fields to keep member output small.

    Inputs1 required, 1 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    fieldsOptional
    Comma-separated Trello member fields to request; use all for detailed follow-up reads.
    Scope
    single resource or visible collection
    Result
    member array

  • card_member_add

    Writes data

    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.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    memberIdRequired
    Trello member id to add or remove from the card.
    Scope
    single Trello mutation
    Result
    assignment confirmation

  • card_member_remove

    Writes data

    Use when unassigning a Trello member from a card by member id; requires write access to the card's board.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    memberIdRequired
    Trello member id to add or remove from the card.
    Scope
    single Trello mutation
    Result
    unassignment confirmation

Comments and card activity

Review card history and add, edit, or permanently delete individual comments.

Example prompt: “Show the latest activity and comments on this card. Do not make changes.”

4 tools

  • card_comment_add

    Writes data

    Use when adding a new comment to a Trello card; returns the created comment action.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    textRequired
    Comment text to add to the card.
    Scope
    single Trello mutation
    Result
    created comment action

  • card_comment_update

    Writes data

    Use when editing the text of an existing Trello card comment by its comment action id.

    Inputs2 required
    actionIdRequired
    Trello comment action id to update.
    textRequired
    Updated comment text.
    Scope
    single Trello mutation
    Result
    updated comment action

  • card_comment_delete

    Writes dataPermanent delete

    Use when deleting an existing Trello card comment by its comment action id.

    Inputs1 required
    actionIdRequired
    Trello comment action id to delete.
    Scope
    single permanent deletion
    Result
    validated deletion response

  • card_actions

    Read only

    Use when auditing recent activity or comments for a card; use filter, limit, page, since, before, and fields to page large histories.

    Inputs1 required, 10 optional
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    filterOptional
    Trello action filter such as all or commentCard.
    fieldsOptional
    Comma-separated Trello action fields to request; use all for detailed follow-up reads. Schema-required fields are added automatically.
    limitOptional
    Maximum number of Trello objects to return; Trello caps this at 1000.
    sinceOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    beforeOptional
    ISO-8601 date, Mongo id, or null cursor for Trello since/before paging.
    pageOptional
    Zero-based result page for Trello action collections.
    memberOptional
    Whether to include member objects on actions.
    memberFieldsOptional
    Comma-separated Trello member fields when member is true.
    memberCreatorOptional
    Whether to include the memberCreator object on actions.
    memberCreatorFieldsOptional
    Comma-separated Trello memberCreator fields when memberCreator is true.
    Scope
    caller-bounded collection
    Result
    action array

Labels

Inspect board or card labels, maintain reusable labels, and apply or remove them from cards.

Example prompt: “Using this label id, show its details and list the labels currently applied to this card. Do not make changes.”

7 tools

  • card_labels

    Read only

    Use when listing the labels currently applied to a card, including label ids for add/remove workflows.

    Inputs1 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    Scope
    single resource or visible collection
    Result
    card label object

  • label_get

    Read only

    Use when you need the current name, color, or board for a specific Trello label before editing it.

    Inputs1 required
    labelIdRequired
    Trello label id.
    Scope
    single resource or visible collection
    Result
    label object

  • label_create

    Writes data

    Use when creating a new reusable label on a Trello board before applying it to cards.

    Inputs3 required
    boardIdRequired
    Trello board id containing the labels.
    nameRequired
    Human-readable label name.
    colorRequired
    Trello label color.
    Scope
    single Trello mutation
    Result
    created label object

  • label_update

    Writes data

    Use when renaming a Trello label or changing its color without changing any card assignments.

    Inputs1 required, 2 optional
    labelIdRequired
    Trello label id.
    nameOptional
    New label name.
    colorOptional
    New Trello label color, or null to remove the color.
    Scope
    single Trello mutation
    Result
    updated label object

  • label_delete

    Writes dataPermanent delete

    Use only when the user explicitly asks to permanently delete a board label from Trello.

    Inputs1 required
    labelIdRequired
    Trello label id.
    Scope
    single permanent deletion
    Result
    validated deletion response

  • card_label_add

    Writes data

    Use when applying an existing Trello label to a card by label id.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    labelIdRequired
    Trello label id to add or remove.
    Scope
    single Trello mutation
    Result
    label assignment confirmation

  • card_label_remove

    Writes data

    Use when removing an existing Trello label from a card by label id.

    Inputs2 required
    cardIdRequired
    Trello card id, short link, or Trello card URL.
    labelIdRequired
    Trello label id to add or remove.
    Scope
    single Trello mutation
    Result
    label removal confirmation

Search cards, boards, members, and workspaces with explicit scopes, fields, and result limits.

Example prompt: “Search for cards mentioning launch and return at most ten matches. Do not make changes.”

2 tools

  • search_members

    Read only

    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.

    Inputs1 required, 4 optional
    queryRequired
    Natural language Trello search query.
    limitOptional
    Maximum number of Trello members to return; Trello caps this at 20.
    boardIdOptional
    Optional board id to scope member search.
    organizationIdOptional
    Optional workspace id to scope member search.
    onlyOrgMembersOptional
    Whether to restrict results to workspace members.
    Scope
    caller-bounded search
    Result
    member array

For supported and deferred Trello REST endpoint families, see API coverage.