> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Trello **Authentication:** API key and token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * List cards on the `Sprint 14` board still in `To do` after 7 days. * Create a card on the `Backlog` list for each row in this triage doc. * Move every `Done` card older than 30 days to the archive list. ## Available Tools #### list\_boards List all boards accessible to the authenticated member. #### get\_board Get detailed information about a specific board by its ID. #### create\_board Create a new Trello board with the specified name and optional configuration. #### update\_board Update an existing board's properties such as name, description, closed status (archive/unarchive), organization, and various preferences including permission level, background, voting, and comments settings. #### delete\_board Permanently delete a board and all of its contents including lists, cards, checklists, labels, and all associated data. #### get\_board\_lists Get all lists on a specific board. #### get\_board\_cards Get all cards on a specific board across all lists. #### get\_board\_members Get all members of a specific board. #### add\_board\_member Add a member to a board with a specified membership type (admin, normal, or observer). The member must already exist in Trello. Use the member's Trello ID, username, or email address to identify them. #### remove\_board\_member Remove a member from a board, revoking their access to view or edit the board and its contents. #### get\_board\_labels Get all labels defined on a specific board. #### get\_card Get detailed information about a specific card by its ID. #### create\_card Create a new card on a list. #### update\_card Update an existing card's properties including name, description, due date, start date, position, labels, assigned members, cover image, and more. #### delete\_card Permanently delete a card and all of its contents including comments, checklists, attachments, and activity history. #### archive\_card Archive or unarchive a card. #### move\_card Move a card to a different list, optionally specifying a position (top, bottom, or numeric) within the target list. #### add\_card\_member Add a member to a card, assigning them to the task. The member must already be a member of the board containing the card. Multiple members can be assigned to a single card. #### remove\_card\_member Remove a member from a card, unassigning them from the task. The member will no longer receive notifications for this card and will not appear in the card's member list. #### add\_card\_label Add a label to a card for categorization. The label must already exist on the board. Labels help visually categorize cards and can be used for filtering. Multiple labels can be added to a single card. #### remove\_card\_label Remove a label from a card. The label itself is not deleted from the board, only removed from this specific card. Other cards with the same label are not affected. #### get\_card\_comments Get all comments (actions of type commentCard) on a specific card. #### add\_card\_comment Add a comment to a card. Comments provide a way to discuss the card with team members, leave notes, or document decisions. The comment will include the author and timestamp automatically. #### update\_card\_comment Update an existing comment on a card. Only the comment author can edit their comments. The comment will show an 'edited' indicator after modification. #### delete\_card\_comment Delete a comment from a card. Only the comment author or board admins can delete comments. Deleted comments cannot be recovered. #### get\_card\_attachments Get all attachments on a specific card. #### add\_card\_attachment Add an attachment to a card via URL. #### delete\_card\_attachment Delete an attachment from a card. The attached file or link will be removed and cannot be recovered. If the attachment was the card's cover, the cover will be removed as well. #### get\_card\_checklists Get all checklists on a specific card. Returns checklist names, items, completion status, and positions. Checklists help break down cards into smaller, trackable tasks. #### create\_checklist Create a new checklist on a card. #### update\_checklist Update an existing checklist's name or position on the card. Changes to the checklist name are reflected immediately. Position determines the order of checklists on the card. #### delete\_checklist Delete a checklist from a card. All check items within the checklist will also be deleted. This action cannot be undone. #### add\_checklist\_item Add a new item to a checklist. Check items represent individual tasks or steps within a checklist. You can set the initial state (checked/unchecked), due date, and assign a member to the item. #### update\_checklist\_item Update a checklist item's name, state (complete/incomplete), position, due date, or assigned member. #### delete\_checklist\_item Delete an item from a checklist. The item will be permanently removed from the checklist. This action cannot be undone. #### create\_label Create a new label on a board. #### update\_label Update an existing label's name or color. You can change the label text, change its color, or set color to null to remove the color. Changes affect the label everywhere it is used on cards. #### delete\_label Delete a label from a board. The label will be removed from all cards that have it applied. This action cannot be undone. #### get\_list Get detailed information about a specific list by its ID. #### create\_list Create a new list on a board. #### update\_list Update an existing list's properties including name, position, closed status (archive/unarchive), and subscription status. Can also move a list to a different board by specifying a new board ID. #### archive\_list Archive or unarchive a list. #### move\_list Move a list to a different board. All cards within the list will also be moved to the target board. The list will appear at the end of the target board's lists by default. #### get\_list\_cards Get all cards in a specific list. #### get\_member Get detailed information about a specific Trello member by their ID or username. #### get\_current\_member Get information about the currently authenticated Trello member (the user whose API token is being used). #### search\_members Search for Trello members by name or username. Returns matching members with their basic profile information. Can optionally limit search to members of a specific board or organization. #### search Search across Trello for boards, cards, members, and organizations.