Skip to main content
Trello MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 15
  • Triggers: 0
  • Slug: TRELLO_MCP
  • Version: 00000000_00

Tools

Slug: TRELLO_MCP_TRELLO_READ_BOARDRead Trello boards. Supports listing boards the authenticated user is a member of, listing all boards a user can access within a specific workspace (regardless of membership), fetching a single board by ARI or URL, listing labels on a board, listing a board’s custom field definitions, and listing a board’s action/history.

Input Parameters

array
Filter board history by action type(s). Only valid when action=“list_activity”; defaults to all action types when omitted.
integer
Maximum results per page, max 100. Defaults to 25 for “list”, “list_by_workspace”, “list_labels”, and “list_custom_fields”; defaults to 50 for “list_activity”. Only valid for paginated actions.
string ("list" | "list_by_workspace" | "get" | "list_labels" | "list_custom_fields" | "list_activity")
required
Action to perform. “list” — paginated boards the authenticated user is a member of, across all workspaces. Use this for “my boards”, “boards I’m on”. It does NOT include boards the user could access but has not joined — for those, use “list_by_workspace”. By default only open (non-archived) boards are returned; pass filter=“all” to include archived boards or filter=“closed” for only archived ones. Always include each board’s url verbatim in the response. Optionally also filtered by visibility (limit defaults to 25, max 100). The open/closed filter is applied server-side (exact), whereas the visibility filter is applied per page — keep paginating via pageInfo.endCursor while pageInfo.hasNextPage is true to find all matches. “list_by_workspace” — paginated boards the user can access within ONE workspace (requires workspaceId), regardless of whether they are a member. Use this when the user names a workspace: “boards in <workspace>”, “what’s in this workspace”. Supports the same open/closed filter, visibility filter, and pagination as “list”. Always include each board’s url verbatim in the response. “get” — return a single board by ARI or board URL (e.g. https://trello.com/b/&lt;shortLink&gt;/&lt;slug>), including id, objectId, name, closed, shortLink, lastActivityAt, and url. Always include the board url verbatim as the full literal URL — never replace it with a label such as “View on Trello” or hide it behind link text; never omit it. Embeds the first 25 open lists with a listsHasMore flag; for the full set call trelloReadList with action=“list_by_board”. “list_labels” — paginated labels on a board (requires boardId; limit defaults to 25, max 100); paginate via nextCursor while hasMore is true. “list_custom_fields” — paginated custom field definitions on a board (requires boardId; limit defaults to 25, max 100). Each field includes its name, type (‘checkbox’ | ‘date’ | ‘list’ | ‘number’ | ‘text’), position, and options (present only for ‘list’ dropdown fields); paginate via nextCursor while hasMore is true. “list_activity” — paginated action/history events on a board: comments, card moves, member changes, attachments, checklists, due date updates, check item state changes, and custom field updates (requires boardId, which may be an ARI or a board URL; limit defaults to 50, max 100). Optionally filter by type. Paginate via nextCursor while hasMore is true. Every entry is an action on the card in its “card” field; name that entity type when you report one.
string
Pagination cursor. Only valid for paginated actions (“list”, “list_by_workspace”, “list_labels”, “list_custom_fields”, “list_activity”).
string ("open" | "closed" | "all")
Filter boards by open/closed state. “open” (default) returns only active (non-archived) boards; “closed” returns only archived boards; “all” returns both. When the user asks broadly — “all my boards”, “boards I can access”, “list my boards” — use the default “open”. Switch to “all” only when the user explicitly asks to include closed/archived boards (e.g. “including closed boards”), and “closed” when they want only archived ones. Only valid when action=“list” or action=“list_by_workspace”.
string
Trello board identifier. Required for “get”, “list_labels”, “list_custom_fields”, and “list_activity”; not allowed for other actions. For action=“get” and action=“list_activity”, accepts an ARI (e.g. ari:cloud:trello::board/workspace/<workspaceId>/<boardId>) or a Trello board URL (e.g. https://trello.com/b/&lt;shortLink&gt;/&lt;slug>). For all other actions, boardId must be a board ARI — board URLs/short links are not supported.
string ("private" | "workspace" | "public")
Filter boards by visibility (“private” | “workspace” | “public”). Only valid when action=“list” or action=“list_by_workspace”.
string
Trello workspace identifier. Required for action=“list_by_workspace”; not allowed for other actions. Accepts an ARI (e.g. ari:cloud:trello::workspace/<workspaceId>).
Slug: TRELLO_MCP_TRELLO_READ_CARDFetch a Trello card’s full details, or list cards across a board or list to surface open work items. Use this tool when you know the specific board, list, or card you want to inspect. For keyword-based discovery across all boards/cards, use trelloSearch instead. Actions:
  • “get”: fetch a single card by id or card URL (cardIdOrUrl required). Returns core card fields, labels (up to 25; truncation signalled via labelsHasMore), and comments (up to 25; truncation signalled via commentsHasMore).
  • “list_by_board”: fetch all cards for a board grouped by list (boardIdOrUrl required). Response: { lists: [{ id, name, cards: […] }], hasNextPage, nextCursor }. Each page contains up to 5 lists (configurable via limit); each list contains all its cards. Filter by card state: “open” (default), “archived”, or “all”. Use cursor/limit to paginate over lists (max 50 lists per page).
  • “list_by_list”: fetch cards in a Trello list (listId required) with cursor-based pagination. Use this when the user asks for cards in a list or all cards from a specific list. Response: { cards: […], pageInfo: { hasNextPage, endCursor } }. Filter by card state: “open” (default), “archived”, or “all”. Use cursor/limit to paginate (max 50 cards per page).
  • “get_comment”: fetch a single comment on a card by its action ID (cardIdOrUrl and commentId required). For this action, cardIdOrUrl must be a Trello card ARI so the workspace is explicit for authorization. Response: { id, text, createdAt, lastEditedAt, creator, cardId }.
  • “list_comments”: list comments on a card, newest first (cardIdOrUrl required). Response: { comments: [{ id, text, createdAt, lastEditedAt, creator }], pageInfo: { hasNextPage, endCursor } }. Use cursor/limit to paginate (default 25, max 50 comments per page).
  • “list_attachments”: list files and links attached to a card (cardIdOrUrl required). Response: { attachments: [{ id, name, fileName, url, mimeType, bytes, createdAt, isUpload, isMalicious }], pageInfo: { hasNextPage, endCursor } }. Use cursor/limit to paginate (default 25, max 50 attachments per page).
  • “list_custom_field_items”: list the custom field values set on a card (cardIdOrUrl required). Pairs with trelloReadBoard “list_custom_fields” for the field definitions these values belong to. Response: { customFieldItems: [{ id, customField: { id, name, type }, value: { text, number, date, checked, optionId } }], pageInfo: { hasNextPage, endCursor } }. Only the value field matching the customField.type is populated (e.g. text fields set value.text). optionId references a customField option for list/dropdown fields. Use cursor/limit to paginate (default 25, max 50 items per page).
  • “list_activity”: list a card’s full activity history, newest first (cardIdOrUrl required). Unlike “list_comments” this is unfiltered: comments, moves between lists, member add/remove, due-date changes, attachments and checklist item state changes all appear in one feed. Response: { activity: [{ id, type, displayKey, date, creator, …typeSpecificFields }], pageInfo: { hasNextPage, endCursor } }. Every entry has id, type, displayKey, date and creator. Type-specific fields are present only for their own action type and omitted otherwise: commentText/commentLastEditedAt, listBefore/listAfter, member, attachment, dueDate, checkItem. Other action types appear with the common fields alone. Trello reuses “type” across different edits (a list move and a due-date change are both “updateCard”), so branch on “displayKey” or on which type-specific field is present, rather than on “type” alone. Same entry shape as trelloReadBoard “list_activity”, minus its “card” field. Every entry is an action on the card you asked for; name that entity type when you report one. Use “list_comments” when the user only wants the discussion; use “list_activity” for “what happened to this card” or “who changed this and when”. Use cursor/limit to paginate (default 25, max 50 entries per page).
Due date timezone handling: Card due dates (due.date) are stored as UTC ISO 8601 timestamps. For “today” or date-based due-date requests, first call trelloReadMember (get_me) for prefs.timezone and interpret due dates in the user’s local time.

Input Parameters

integer
Pagination limit (1-50) for the list actions, “list_comments”, “list_attachments”, “list_custom_field_items”, and “list_activity” (default 25). Not allowed for “get” or “get_comment”.
string ("get" | "list_by_board" | "list_by_list" | "get_comment" | "list_comments" | "list_attachments" | "list_custom_field_items" | "list_activity")
required
Action to perform: “get” fetches a single card, “list_by_board” fetches cards grouped by list for a board, “list_by_list” fetches cards in a specific list, “get_comment” fetches a single comment on a card, “list_comments” lists comments on a card, “list_attachments” lists files/links attached to a card, “list_custom_field_items” lists the card’s custom field values, “list_activity” lists the card’s full activity history.
string
Pagination cursor for the list actions, “list_comments”, “list_attachments”, “list_custom_field_items”, and “list_activity”. Not allowed for “get” or “get_comment”.
string
Card state filter for “list_by_board” and “list_by_list”. One of: “open” (default), “archived”, “all”. Not allowed for “get”, “get_comment”, “list_comments”, “list_attachments”, “list_custom_field_items”, or “list_activity”.
string
Trello list identifier. Required for “list_by_list”. Accepts an ARI (e.g. ari:cloud:trello::list/workspace/<workspaceId>/<listId>).
string
Trello comment/action identifier. Required for “get_comment”. Accepts an ARI (e.g. ari:cloud:trello::action/<actionId>).
string
Trello card identifier. Required for “get”, “get_comment”, “list_comments”, “list_attachments”, “list_custom_field_items”, and “list_activity”. For “get_comment”, cardIdOrUrl must be a Trello card ARI. Accepts an ARI (e.g. ari:cloud:trello::card/workspace/<workspaceId>/<cardId>) or a Trello card URL (e.g. https://trello.com/c/&lt;shortLink&gt;/&lt;slug>).
string
Trello board identifier. Required for “list_by_board”. Accepts an ARI (e.g. ari:cloud:trello::board/workspace/<workspaceId>/<boardId>). A Trello board URL is also accepted (e.g. https://trello.com/b/&lt;shortLink&gt;/&lt;slug>).
Slug: TRELLO_MCP_TRELLO_READ_CHECKLISTRead Trello checklists (and their check items) attached to a card. Supported actions: “list_by_card” — list checklists on a card (cardId required); cursor/limit page the checklists. “get” — fetch a single checklist by id (checklistId required). In both actions each checklist is returned with its complete items list embedded.

Input Parameters

integer
Pagination limit (1-100, default 25) for “list_by_card” (caps checklists). Not allowed for “get”.
string ("list_by_card" | "get")
required
The read action to perform: “list_by_card” or “get”.
string
Trello card ARI (e.g. “ari:cloud:trello::card/workspace/<workspaceId>/<cardId>”). Required for “list_by_card”.
string
Pagination cursor for “list_by_card” (pages checklists). Not allowed for “get”.
string
Trello checklist ARI (e.g. “ari:cloud:trello::checklist/workspace/<workspaceId>/<checklistId>”). Required for “get”.
Slug: TRELLO_MCP_TRELLO_READ_INBOXTriage and review the authenticated user’s Trello Inbox — the personal quick-capture board where new cards and notifications land. Use this specifically for the user’s Inbox board. For cards on other boards or lists, use trelloReadCard instead. Actions: “get” — return the Inbox board details (id, objectId, lastActivityAt). No additional arguments are needed. “list_cards” — list cards in the Inbox with optional filtering and pagination. Each card includes labels and up to 25 checklists (truncation signalled via checklistsHasMore). Filter by card state: “open” (default), “archived”, or “all”. Use cursor/limit to paginate (limit defaults to 25, max 50).

Input Parameters

integer
Maximum number of cards to return per page. Defaults to 25, max 50. Only valid when action=“list_cards”.
string ("get" | "list_cards")
required
Action to perform. “get” returns the Inbox board details. “list_cards” returns paginated cards in the Inbox (filter/cursor/limit are optional).
string
Pagination cursor. Only valid when action=“list_cards”.
string
Card state filter for “list_cards”. One of: “open” (default), “archived”, “all”. Not allowed for “get”.
Slug: TRELLO_MCP_TRELLO_READ_LISTRead Trello lists. Supported actions: “list_by_board” — list the open lists on a board (id, name, position, objectId) with cursor-based pagination (limit defaults to 25, max 50); “get” — return a single list by id, including up to 25 nested cards (id, name).
  • “list_activity” — page through open cards currently in a list and return each card’s recent activity. Only the cards are paginated (cursor/limit, defaults to 25 cards, max 50); each card returns its 25 most recent activity entries. Use trelloReadCard to get a single card’s full history. Every entry is an action on the card it is grouped under; name that entity type when you report one.

Input Parameters

integer
Maximum items to return per page. Defaults to 25, max 50. Counts lists when action=“list_by_board” and cards when action=“list_activity”. Not valid when action=“get”.
string ("list_by_board" | "get" | "list_activity")
required
Action to perform. “list_by_board” requires boardId (cursor/limit are optional). “get” requires listId and does not allow pagination. “list_activity” requires listId and returns open cards with their 25 most recent activity entries each (cursor/limit are optional).
string
Pagination cursor for “list_by_board” or “list_activity”.
string
Trello list identifier. Required when action=“get” or action=“list_activity”. Accepts an ARI (e.g. ari:cloud:trello::list/workspace/<workspaceId>/<listId>).
string
Trello board identifier. Required when action=“list_by_board”. Accepts an ARI (e.g. ari:cloud:trello::board/workspace/<workspaceId>/<boardId>).
Slug: TRELLO_MCP_TRELLO_READ_MEMBERGet a Trello member’s profile. Call action=“get_me” FIRST before any due-date query (e.g. “cards due today”, “overdue cards”) to get prefs.timezone (e.g. “America/Los_Angeles”) so due dates can be interpreted in the user’s local time rather than UTC. Also use action=“get_me” to look up the current user’s username, fullName, email, or avatarUrl. Supported actions: “get_me” — returns the authenticated user’s Trello member profile (id, username, fullName, email, avatarUrl, url, prefs) via the Trello GraphQL API. “get” — returns another Trello member’s profile (id, username, fullName, avatarUrl, url, prefs) by memberId. “list_by_board” — lists a board’s members with their board role (admin, member, observer) by boardId, with cursor-based pagination (limit defaults to 25, max 100). “list_by_workspace” — lists a workspace’s members with their workspace role (admin, member) by workspaceId, with the same cursor-based pagination. Workspace membership cannot be filtered by role. “list_by_card” — returns a paginated list of members assigned to a card, with nextCursor and hasMore.

Input Parameters

string ("admin" | "member" | "observer")
Only return members with this board role. Only valid when action=“list_by_board” — workspace membership cannot be filtered by role.
integer
Maximum number of members to return per page. Defaults to 25, max 100. Only valid for member list actions.
string ("get_me" | "get" | "list_by_board" | "list_by_workspace" | "list_by_card")
required
The read action to perform. “get_me” returns the authenticated user’s profile. “get” returns a specific member’s profile by memberId. “list_by_board” returns a board’s members and their board role by boardId. “list_by_workspace” returns a workspace’s members and their workspace role by workspaceId. “list_by_card” lists members assigned to cardId.
string
Trello card identifier. Required for “list_by_card”; not allowed for other actions. Accepts an ARI (e.g. ari:cloud:trello::card/workspace/<workspaceId>/<cardId>).
string
Pagination cursor. Only valid for member list actions.
string
Trello board identifier. Required for “list_by_board”; not allowed for other actions. Accepts an ARI (e.g. ari:cloud:trello::board/workspace/<workspaceId>/<boardId>).
string
Trello member identifier. Required for “get”; not allowed for any other action. Accepts an ARI (e.g. ari:cloud:trello::user/<memberId>).
string
Trello workspace identifier. Required for “list_by_workspace”; not allowed for other actions. Accepts an ARI (e.g. ari:cloud:trello::workspace/<workspaceId>).
Slug: TRELLO_MCP_TRELLO_READ_PLANNERRead Trello Planner information for the authenticated user. Supported actions: “get” — returns the current member’s planner (id, primaryAccountId, primaryCalendarId, primaryCalendar details); “list_events” — lists calendar events for a given planner calendar in a time window (plannerCalendarId, providerAccountId, start, end required; limit defaults to 25, max 50; cursor-based pagination supported); “get_event” — returns a single calendar event by provider event id (eventId, providerAccountId, plannerCalendarId required). Timezone handling: start and end must be UTC ISO 8601. For relative time queries like “today” or “this week”, first use the “get” action to retrieve primaryCalendar.timezone, then convert to UTC before calling “list_events”.

Input Parameters

string
Event window end as a UTC ISO 8601 date-time string. Must be after start. For relative queries like “today”, first use the “get” action to retrieve primaryCalendar.timezone and convert to UTC. Required for “list_events”.
integer
Maximum number of events to return. Defaults to 25, max 50. Only valid for “list_events”.
string
Event window start as a UTC ISO 8601 date-time string. For relative queries like “today”, first use the “get” action to retrieve primaryCalendar.timezone and convert to UTC. Required for “list_events”.
string ("get" | "list_events" | "get_event")
required
Action to perform. “get” takes no additional args and returns the current member’s planner. “list_events” requires plannerCalendarId, providerAccountId, start, end (cursor and limit optional). “get_event” requires eventId, providerAccountId, plannerCalendarId.
string
Pagination cursor. Only valid for “list_events”.
string
Provider event ID. Required for “get_event”.
string
Trello planner calendar identifier. Required for “list_events” and “get_event”. Accepts an ARI (e.g. ari:cloud:trello::planner-calendar/<calendarId>).
string
Provider account ARI (e.g. Google account ARI like “ari:third-party:google::account/<id>”). Required for “list_events” and “get_event”.
Slug: TRELLO_MCP_TRELLO_READ_WORKSPACERead Trello workspaces (organizations) the current user has access to. Supported actions: “list” — list workspaces visible to the authenticated user (cursor-based pagination, limit defaults to 25, max 100); “get” — fetch detailed data for a single workspace by id (typically used after “list” to drill into a workspace).

Input Parameters

integer
Maximum number of workspaces to return (default 25, max 100). Only valid for “list” action.
string ("list" | "get")
required
The read action to perform. “list” returns paginated workspaces; “get” returns a single workspace by id.
string
Pagination cursor for the next page. Only valid for “list” action.
string
Trello workspace identifier. Required for “get” action. Accepts an ARI (e.g. ari:cloud:trello::workspace/<workspaceId>).
Slug: TRELLO_MCP_TRELLO_SEARCHDiscover Trello boards or cards by keyword across all workspaces. Use this when the user wants to find something by name or content but does not know which board it is on. If the user already knows the board or list they want to browse, use trelloReadCard (list_by_board or list_by_list) instead — it is faster and returns richer grouped results. Supported actions: “search_boards” — search for boards by name, always include each board’s url verbatim in the response; “search_cards” — search for cards by name/content. Both support optional workspace scoping and cursor-based pagination. Both actions return open (non-archived) results by default. To search archived items instead, include is:archived in the query. “search_cards” additionally supports boardIds scoping and qualifiers: label:, board:, list:, member:, due:, has:. For archived/closed cards, use is:archived or is:closed (they are equivalent for cards only). For archived boards, use is:archived only — boards do not support the is:closed alias. Due date timezone handling: Trello due-date search qualifiers use UTC boundaries. For “today” or date-based due-date queries, first call trelloReadMember (get_me) for prefs.timezone and account for the user’s local timezone.

Input Parameters

integer
Maximum number of results to return (default 10, max 100).
string
required
Required free-text query string to search for (min 1 character).
string ("search_boards" | "search_cards")
required
The search action to perform: “search_boards” or “search_cards”.
string
Pagination cursor from a prior response’s nextCursor field.
boolean
Enable partial/prefix matching on names (default false).
array
Optional list of board ARIs to scope card search results (e.g. [“ari:cloud:trello::board/workspace/<workspaceId>/<boardId>”]).Only valid for “search_cards”.
array
Optional list of workspace ARIs to scope search results (e.g. [“ari:cloud:trello::workspace/<workspaceId>”]). Valid for both “search_boards” and “search_cards”.
Slug: TRELLO_MCP_TRELLO_WRITE_BOARDCreate Trello boards. Supported actions: “create” — create a Trello board in a workspace with a name, visibility, and optional preferences.

Input Parameters

string
Board description. Optional for “update”.
string
Board name. Required for “create”.
string ("green" | "green_dark" | "green_light" | "yellow" | "yellow_dark" | "yellow_light" | "orange" | "orange_dark" | "orange_light" | "red" | "red_dark" | "red_light" | "purple" | "purple_dark" | "purple_light" | "blue" | "blue_dark" | "blue_light" | "sky" | "sky_dark" | "sky_light" | "lime" | "lime_dark" | "lime_light" | "pink" | "pink_dark" | "pink_light" | "black" | "black_dark" | "black_light")
Label color. Required for “create_label”, optional for “update_label”; not allowed for other actions.
object
Optional board preferences payload. Only valid for “create”.
string ("create")
required
Board write action to perform. “create” creates a board in a workspace.
string
Trello board ARI — the id field returned by trelloReadBoard (e.g. “ari:cloud:trello::board/workspace/<workspaceId>/<boardId>”). Required for “update” and “archive”.
string
Trello label ARI (e.g. “ari:cloud:trello::label/workspace/<workspaceId>/<labelId>”). Required for “update_label”.
string ("ENTERPRISE" | "ORG" | "PRIVATE" | "PUBLIC")
Board visibility. Supported values: ENTERPRISE, ORG, PRIVATE, PUBLIC. Use ORG for workspace visibility. Optional for “create” (defaults to PRIVATE) and for “update”.
string
Trello workspace identifier that will own the new board. Required for “create”. Accepts an ARI (e.g. ari:cloud:trello::workspace/<workspaceId>).
Slug: TRELLO_MCP_TRELLO_WRITE_CARDCreate, update, move, archive, mark Trello cards done, or manage labels on cards. Supported actions: “create” — create a card on a list (listId and name required; desc, due, pos optional); “update” — update an existing card (cardId required; at least one of name, desc, due required); “move” — move a card to another list, optionally across boards (cardId and listId required, where listId is the destination list; boardId is optional and only needed when moving to a list on a different board; pos is optional and sets the card position in the destination list); “archive” — archive a card (cardId required); “mark_done” — mark a card as complete (cardId required); “attach_label” — attach a label to a card (cardId and labelId required); “detach_label” — detach a label from a card (cardId and labelId required). “add_comment” — post a comment on a card (cardId and text required); “update_comment” — replace the text of an existing comment on a card (cardId, commentId and text required).

Input Parameters

string
Card due date as a UTC ISO 8601 date-time string (e.g. “2026-06-01T17:00:00.000Z”). Optional for “create” and “update”.
string
Card position. Optional for “create”, “move”, and “copy”. Use “top”, “bottom”, or a non-negative number (e.g. 16384).
string
Card description. Optional for “create” and “update”.
string
Card name. Required for “create”; optional for “update” and “copy”.
string
Comment text. Required for “add_comment”; for “update_comment” this is the replacement text for the comment.
string ("create" | "update" | "move" | "archive" | "mark_done" | "attach_label" | "detach_label" | "add_comment" | "update_comment")
required
Action to perform: “create” creates a card; “update” updates card fields; “move” moves a card to another list; “archive” archives a card; “mark_done” marks a card complete; “attach_label” attaches a label to a card; “detach_label” detaches a label from a card. “add_comment” posts a comment on a card; “update_comment” edits an existing comment on a card.
string
Trello card ARI — the id field returned by trelloReadCard (e.g. “ari:cloud:trello::card/workspace/<workspaceId>/<cardId>”). Do NOT pass a Trello URL or short link; use trelloReadCard first to obtain the ARI. Required for “update”, “move”, “copy”, “archive”, “mark_done”, “attach_label”, “detach_label”, “add_comment”.
string
Trello list ARI (e.g. “ari:cloud:trello::list/workspace/<workspaceId>/<listId>”). For “create”, this is the list the new card is added to. For “move”, this is the destination list the card is moved to. For “copy”, this is the optional destination list; omit it to copy within the source list. Required for “create” and “move”.
string
Trello board ARI (e.g. “ari:cloud:trello::board/workspace/<workspaceId>/<boardId>”). Only used by “move”: pass the destination board ARI when moving a card to a list on a different board. Omit when moving within the same board. Must be paired with listId — boardId on its own is not allowed.
string
Trello label ARI (e.g. “ari:cloud:trello::label/workspace/<workspaceId>/<labelId>”). Required for “attach_label” and “detach_label”.
string
Trello member ARI (e.g. “ari:cloud:trello::user/<memberId>”). Use trelloReadMember “list_by_board” to find the member ARI. Required for “add_member”.
string
Trello comment/action ARI (e.g. “ari:cloud:trello::action/<actionId>”) — the id field returned by trelloReadCard (“get_comment” or “list_comments”). Required for “update_comment”, and must be a comment on the card given by cardId.
string
Trello custom field ARI (e.g. “ari:cloud:trello::customField/workspace/<workspaceId>/<customFieldId>”). Use trelloReadBoard “list_custom_fields” to find the ARI. Required for “set_custom_field_value”.
object
Value to set on the custom field. Required for “set_custom_field_value”. Pass exactly one of: text (text field), number (number field, as string), date (date field, ISO 8601), checked (checkbox field), valueId (list/dropdown option ARI), or clear: true to remove the value.
Slug: TRELLO_MCP_TRELLO_WRITE_CHECKLISTWrite Trello checklists and their check items. Actions: “create” — add a new checklist to a card by cardId and name, optionally placed at “top”, “bottom”, or an explicit numeric position. Returns the created checklist as a TrelloChecklist (id, objectId, name, position, checkItems[]). “add_item” — append a new check item to an existing checklist by checklistId and text, optionally placed at “top”, “bottom”, or an explicit numeric position. Returns the created check item (id, name, state, position) using the same normalized shape as trelloReadChecklist. “update_item” — update an existing check item by checklistId and itemId; supports renaming (text), toggling completion (checked), repositioning (pos), and moving to another checklist on the same card (toChecklistId). Returns the updated check item. “update” — rename a checklist (name) and/or change its position on its card (pos) by checklistId. At least one of name or pos must be supplied. Returns the resulting checklist in the same normalized shape as trelloReadChecklist (id, name, position, checkItems[]).

Input Parameters

string
Position of the new checklist on the card (action=“create”), the initial position of the new check item within the checklist (action=“add_item”), an existing check item (action=“update_item”), or an existing checklist on its card (action=“update”). “top” or “bottom” places it relative to existing items; a number sets an explicit absolute position.
string
Name of the checklist. Required when action=“create”. Optional for action=“update” (renames the checklist).
string
Text (name) of the check item. Required when action=“add_item”; optional rename when action=“update_item”.
string ("create" | "add_item" | "update_item" | "update" | "add_member")
required
Action to perform. “create” requires cardId and name (pos is optional). “add_item” requires checklistId and text (pos is optional). “update_item” requires checklistId and itemId (text, checked, pos, toChecklistId are optional). “update” requires checklistId and at least one of name or pos.
string
Trello card ARI — the id field returned by trelloReadCard (e.g. “ari:cloud:trello::card/workspace/<workspaceId>/<cardId>”). Do NOT pass a Trello URL or short link; use trelloReadCard first to obtain the ARI. Required when action=“create”.
string
Trello check item identifier. Required when action=“update_item”. Accepts an ARI (e.g. ari:cloud:trello::check-item/workspace/<workspaceId>/<itemId>).
boolean
Whether the check item is completed. Optional when action=“update_item”.
string
Member to assign to the check item (e.g. “ari:cloud:trello::user/<memberId>”). Use trelloReadMember “list_by_board” to find the member ARI. Only valid for action=“add_item” and action=“add_member”.
string
Trello checklist identifier. Required when action=“add_item”, action=“update_item”, or action=“update”. Accepts an ARI (e.g. ari:cloud:trello::checklist/workspace/<workspaceId>/<checklistId>).
string
Target checklist ARI to move the check item into (e.g. “ari:cloud:trello::checklist/workspace/<workspaceId>/<checklistId>”). The target checklist must be on the same card. Only valid for action=“update_item”.
Slug: TRELLO_MCP_TRELLO_WRITE_INBOXWrite Trello Inbox cards. Supported actions: “create” — create a new card in the Trello Inbox (name required; desc and due are optional). The Inbox list is resolved automatically — no listId needed. “update” — update fields on an existing Inbox card (cardId required; at least one of name, desc, or due required). “move” — move an Inbox card to another list and board (cardId, listId, and boardId required; pos optional). “archive” — archive an existing Inbox card (cardId required; no other fields allowed). Returns the created, updated, moved, or archived card including its id.

Input Parameters

string
Card due date as a UTC ISO 8601 date-time string (e.g. “2026-06-01T17:00:00.000Z”). Optional for “create” and “update”.
string
Card position after move. Optional for “move”. Use “top”, “bottom”, or a non-negative number (e.g. 16384).
string
Card description. Optional for “create” and “update”.
string
Card name. Required for “create”; optional for “update”.
string ("create" | "update" | "move" | "archive")
required
Action to perform. “create” creates a new card in the Trello Inbox; “update” updates card fields; “move” moves a card to another list; “archive” archives an existing card.
string
Trello Inbox card ARI — the id field returned by trelloReadInbox (e.g. “ari:cloud:trello::card/workspace/<workspaceId>/<cardId>”). Do NOT pass a Trello URL or short link; use trelloReadInbox first to obtain the ARI. Required for “update”, “move”, and “archive”; not used for “create”.
string
Trello list ARI (e.g. “ari:cloud:trello::list/workspace/<workspaceId>/<listId>”). Required for “move”: the destination list the card is moved to.
string
Trello board ARI (e.g. “ari:cloud:trello::board/workspace/<workspaceId>/<boardId>”). Required for “move”.
Slug: TRELLO_MCP_TRELLO_WRITE_LISTCreate, update, archive, or move a Trello list. Supported actions: “create” — create a new list on a board (boardId and name required; pos optional); “update” — rename an existing list (listId and name required); “archive” — soft-delete (close) a list (listId required); “move” — reposition a list, optionally moving it to another board (listId and pos required; boardId is optional and only needed when moving the list to a different board).

Input Parameters

string
List position. Required when action=“move”; optional when action=“create”. Use a non-negative number for an absolute position, or the string “top” or “bottom”.
string
List name. Required when action=“create” or action=“update”.
string ("create" | "update" | "archive" | "move")
required
Action to perform: “create”, “update”, “archive”, or “move”.
string
Trello list identifier. Required when action=“update”, action=“archive”, or action=“move”. Accepts an ARI (e.g. ari:cloud:trello::list/workspace/<workspaceId>/<listId>).
string
Trello board identifier. Required when action=“create”. For action=“move”, pass the destination board ARI to move the list to a different board; omit it to reposition within the same board. Accepts an ARI (e.g. ari:cloud:trello::board/workspace/<workspaceId>/<boardId>).
Slug: TRELLO_MCP_TRELLO_WRITE_PLANNERCreate Trello Planner calendar events and manage card-event links. Supported actions: “create_event” — create a calendar event (title, start, and end required; if cardId is provided, the event is linked to that card and title defaults to the card name); “link_card_to_event” — link an existing card to an existing event (cardId and eventId required); “unlink_card_from_event” — unlink a card from an event (cardId and eventId required). providerAccountId and calendarId are optional for all actions; when omitted the user’s primary calendar account is used.

Input Parameters

string
Event end time as a UTC ISO 8601 date-time string. Required for “create_event”.
string
Event start time as a UTC ISO 8601 date-time string. Required for “create_event”.
string
Event title. Required for “create_event” when cardId is not provided. When cardId is provided, defaults to the card name.
string ("create_event" | "link_card_to_event" | "unlink_card_from_event")
required
Action to perform: “create_event”, “link_card_to_event”, or “unlink_card_from_event”.
string
Trello card ARI — the id field returned by trelloReadCard (e.g. “ari:cloud:trello::card/workspace/<workspaceId>/<cardId>”). Do NOT pass a Trello URL or short link; use trelloReadCard first to obtain the ARI. Required for “link_card_to_event” and “unlink_card_from_event”. Optional for “create_event” (when provided, the new event is linked to the card).
string
The planner calendar event ID. Required for “link_card_to_event” and “unlink_card_from_event”.
string
The planner calendar ID to operate on. Optional — when omitted, the user’s primary calendar is used.
string
The provider account ID (e.g. a linked Google or Outlook account ID). Optional — when omitted, the user’s primary planner account is used.