Trelloreadcard
Fetch 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.