Mattering Automations Trello integration
Connect Trello to Mattering Automations: boards, lists, cards, checklists, labels, members, comments, URL attachments, and webhook management as workflow steps, authenticated with a Trello API key and member token.
The Mattering Automations Trello integration adds Trello to your automation canvas: list and search boards, create, update, move, and archive cards, manage lists, checklists and check items, labels, card members, and comments, attach links by URL, and manage the webhook subscriptions that push Trello events to a URL you choose.
Setup takes a few minutes: get an API key and a member token from Trello's Power-Up admin console, attach them as a credential in Mattering, and test the connection. This guide walks through each step and ends with the full node reference.
The integration is honest about what can be undone. Closing a board and archiving a card or list are reversible and ship as their own nodes: Trello: Close / Reopen Board, Trello: Archive / Unarchive Card, and Trello: Archive / Unarchive List. The eight delete nodes are flagged destructive because Trello deletes are permanent, with no trash and no recovery. Verify the integration with read nodes only, and keep the delete nodes behind a condition, an approval step, or a manual run.
Before you start
- A Trello account. The free plan covers everything in this integration except due dates and assignees on check items, which are a Trello Premium feature.
- Access to Trello's Power-Up admin console at trello.com/power-ups/admin, which is where the API key and token come from.
- A Mattering workspace with access to the Automations app.
- For receiving Trello events: a Mattering Automations inbound webhook trigger to use as the webhook callback URL.
Create a Trello API key and member token
Mattering authenticates to Trello with two values: an API key, which identifies the app, and a member token, which authorizes it to act as your Trello member. Both come from the Power-Up admin console; no OAuth flow is involved. Trello sends them as query parameters on every request, and the integration handles that shape safely, as covered in the connect step.
Connect Trello to Mattering
Verify it works
After connecting, open any automation canvas and check the palette: a Trello section should list the query and action nodes. Drop Trello: Get My Member onto the canvas and run a test step. It takes no configuration and is a safe, read-only call; a successful response returns your member id, username, and full name, and exercises both halves of the credential in one request.
To confirm the rest of the surface, run Trello: List My Boards and note a board id, then point Trello: List Lists on Board and Trello: List Cards on Board at it. Board and card ids accept both the 24-character id and the short token from a trello.com board or card URL. Everything in the verify path is read-only; nothing here touches the eight delete nodes.
Node reference
45 nodes, generated from the connector itself so this reference always matches what ships.
Read and query nodes 15
Trello: Get Board
trello_get_board
Get a single board with its name, description, closed state, preferences, and label names. Optional nested resources pull the board's lists, cards, labels, and members in one call.
Trello: Get Card
trello_get_card
Get a single card with its name, description, due date, labels, and badges. Optional nested resources pull the card's attachments, members, checklists, and comment actions in the same call.
Trello: Get List
trello_get_list
Get a single list: name, position, closed state, and the id of the board it belongs to.
Trello: Get My Member
trello_get_me
Get the authenticated Trello member: id, username, full name, and the ids of their boards and Workspaces. Needs no configuration, so it doubles as the credential health check (401 when the key or token is wrong).
Trello: List Board Members
trello_list_board_members
List the members of a board with their ids, usernames, and full names. The returned member ids feed card assignment.
Trello: List Card Attachments
trello_list_card_attachments
List a card's attachments: name, URL, whether it was an upload or a link, and the attachment id used by Delete Attachment.
Trello: List Card Comments
trello_list_card_comments
List a card's comments (commentCard actions), newest first. Each entry carries the comment text under data.text plus the commenting member; the action id feeds Delete Comment.
Trello: List Cards in List
trello_list_list_cards
List the cards in a single list (column), in board order. The classic polling read for column-driven automations.
Trello: List Cards on Board
trello_list_board_cards
List the open cards on a board across all of its lists. For one column only, use Trello: List Cards in List instead.
Trello: List Checklists on Card
trello_list_card_checklists
List a card's checklists with their check items and states. The returned checklist and check item ids feed the check item nodes.
Trello: List Labels on Board
trello_list_board_labels
List a board's labels with their names and colors. The returned label ids feed card labeling and label updates.
Trello: List Lists on Board
trello_list_board_lists
List the lists (columns) on a board, open ones by default. Optionally include each list's cards inline. The returned list ids feed card creation and moves.
Trello: List My Boards
trello_list_my_boards
List the boards the authenticated member belongs to. Filter by open, closed, starred, or organization membership. The returned board ids feed every board-scoped node.
Trello: List Webhooks
trello_list_webhooks
List every webhook registered on this connector's token, with each webhook's model, callback URL, active flag, and failure count. The token in the path is filled in by the connector from the stored credential; it is never part of the node's configuration or output.
Trello: Search
trello_search
Search across the member's cards, boards, members, and Workspaces with Trello's search operators (board:, list:, label:, due:, @member, and friends). Results come back grouped by model type.
Action nodes 30
Trello: Add Check Item
trello_add_checkitem
Add an item to a checklist, optionally already checked, with a due date or an assigned member (due dates and assignees on check items are a Trello Premium feature). Returns the created check item.
Trello: Add Comment to Card
trello_add_comment
Post a comment on a card as the token's member. Returns the created commentCard action; its id is what Delete Comment takes.
Trello: Add Label to Card
trello_add_label_to_card
Add one existing label to a card without touching the card's other labels. Removing it again restores the exact previous state.
Trello: Add Member to Card
trello_add_member_to_card
Assign one board member to a card without touching the card's other members. Removing them again restores the previous state.
Trello: Archive / Unarchive Card
trello_archive_card
Archive a card, or send it back to the board with closed=false. Archived cards keep all their content and are recoverable from the board's archive; this is the reversible alternative to the destructive Delete Card node.
Trello: Archive / Unarchive List
trello_archive_list
Archive a list, or restore it with value=false. Archiving hides the list (and its cards) from the board without deleting anything; Trello has no list delete at all, so archive is the terminal state and it is fully reversible.
Trello: Attach URL to Card
trello_add_attachment_url
Attach a link to a card by URL. This connector attaches by URL only (Trello stores the link, isUpload stays false); the API's multipart file upload is deliberately not exposed because the canvas cannot produce file bytes.
Trello: Close / Reopen Board
trello_close_board
Close (archive) a board, or reopen it with closed=false. A closed board disappears from the boards page but keeps all lists and cards and can be reopened at any time. This is the reversible alternative to the destructive Delete Board node.
Trello: Create Board
trello_create_board
Create a new board. By default Trello seeds it with the To Do, Doing, and Done lists; turn that off with defaultLists=false to start empty. Returns the created board with its id.
Trello: Create Card
trello_create_card
Create a card in a list, with optional description, due and start dates, members, labels, and a source URL that becomes the card's first attachment. Returns the created card with its id and shortUrl.
Trello: Create Checklist
trello_create_checklist
Add a checklist to a card, optionally copying the items of an existing checklist with idChecklistSource. Returns the created checklist with its id.
Trello: Create Label
trello_create_label
Create a new label on a board with a name and one of Trello's named colors. Returns the created label with its id.
Trello: Create List
trello_create_list
Create a new list (column) on a board. Optionally copy an existing list's cards with idListSource. Returns the created list with its id.
Trello: Create Webhook
trello_create_webhook
Register a webhook: Trello will POST every action on the watched model (a board, list, or card id) to your callback URL. MANAGEMENT ONLY: this does not create an Automations trigger by itself; point callbackURL at an Automations inbound webhook trigger URL to receive the events. At creation Trello sends an HTTP HEAD request to the callback and requires a 200 response, or the webhook is not created. Failed deliveries are retried 3 times; a callback answering 410 deletes the webhook.
Trello: Delete Attachment
trello_delete_attachment
DESTRUCTIVE: delete an attachment from a card. A link attachment could be re-added, but a FILE that was uploaded to Trello is permanently gone, so the node is flagged for the worst case it can hit.
Trello: Delete Board
trello_delete_board
DESTRUCTIVE: permanently delete a board and every list and card on it. There is no undo and no trash; a deleted board cannot be recovered by Trello support either. If the board might be needed again, use Close / Reopen Board instead.
Trello: Delete Card
trello_delete_card
DESTRUCTIVE: permanently delete a card with its comments, checklists, and attachments. There is no undo. If the card might be needed again, use Archive / Unarchive Card instead.
Trello: Delete Check Item
trello_delete_checkitem
DESTRUCTIVE: delete a single check item from a checklist. There is no undo; to keep the item but clear it, use Update Check Item with state=incomplete instead.
Trello: Delete Checklist
trello_delete_checklist
DESTRUCTIVE: delete a checklist and every check item on it. There is no undo and no archive state for checklists.
Trello: Delete Comment
trello_delete_comment
DESTRUCTIVE: delete a comment from a card. Only comment actions can be deleted, only by their author or a board admin, and there is no undo.
Trello: Delete Label
trello_delete_label
DESTRUCTIVE: delete a label from its board, stripping it from every card that carries it. There is no undo; to take it off one card only, use Remove Label from Card.
Trello: Delete Webhook
trello_delete_webhook
DESTRUCTIVE: delete a webhook subscription. Delivery stops immediately and the deletion cannot be undone; an equivalent webhook can be recreated with Create Webhook, but it arrives as a new object and events during the gap are lost.
Trello: Move Card
trello_move_card
Move a card to another list (and optionally another board), with an optional position in the destination. The ergonomic shortcut for the most common Trello automation step; moving it back reverses it exactly.
Trello: Remove Label from Card
trello_remove_label_from_card
Take one label off a card. The label itself survives on the board and can be re-added, so this is a reversible write, unlike Delete Label.
Trello: Remove Member from Card
trello_remove_member_from_card
Unassign a member from a card. The member keeps their board access and can be re-added, so this is a reversible write.
Trello: Update Board
trello_update_board
Update a board's name, description, closed state, Workspace, or subscription. Preference fields (prefs/{name}) go through extra_query. Returns the updated board.
Trello: Update Card
trello_update_card
Update any card fields: rename, edit the description, change dates, replace the member or label sets (idMembers and idLabels REPLACE the existing sets), archive with closed, or relocate with idList/idBoard/pos. Returns the updated card.
Trello: Update Check Item
trello_update_checkitem
Update a check item, most importantly its state (complete or incomplete): this is the check/uncheck node. Trello scopes the update to the CARD, so both the card id and the check item id are required.
Trello: Update Label
trello_update_label
Rename a label or change its color. The change applies everywhere the label is used on the board.
Trello: Update List
trello_update_list
Rename or reposition a list, move it to another board with idBoard, or change the acting member's subscription. Returns the updated list.
Using the integration
On the automation canvas
Trello nodes chain with every other node: a scheduled Trello: List Cards in List sweep can compare a column against a Mattering database and close the matching task in Mattering Productivity when a card reaches Done, a form submission can become a card via Trello: Create Card with a comment and a source link attached, and Trello: Move Card handles the single most common Trello automation step, exactly reversibly.
From AI assistants over MCP
Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can list boards, read cards, search across the workspace with Trello: Search, and create or move cards through the same nodes your workflows use. The fifteen query nodes are read-only, which makes them the safest Trello surface to hand an agent.
Archive and close instead of delete
Trello draws a hard line between reversible and permanent, and the integration keeps it visible. Trello: Close / Reopen Board and Trello: Archive / Unarchive Card preserve everything and can be undone at any time. Trello: Delete Board and Trello: Delete Card are permanent, with no trash and no recovery, and are flagged destructive along with the other delete nodes. Lists are the special case: Trello has no list delete at all, so Trello: Archive / Unarchive List is their terminal state, and it is fully reversible.
Incremental writes versus Update Card
The idLabels and idMembers fields on Trello: Update Card replace the whole set, per Trello's API semantics. For one-at-a-time changes use Trello: Add Label to Card, Trello: Remove Label from Card, Trello: Add Member to Card, and Trello: Remove Member from Card: each changes exactly one thing, and running the counterpart restores the previous state exactly.
Attachments by URL
Trello: Attach URL to Card stores a link on the card; Trello's multipart file upload is deliberately not exposed, so URL is the only path and workflow payloads stay light. Deletion is the asymmetric part: Trello: Delete Attachment is flagged destructive because a link attachment can be re-added but a file that was uploaded to Trello is permanently gone, and the node cannot tell which kind it is removing.
Webhooks: management nodes plus an inbound trigger
Trello: Create Webhook, Trello: List Webhooks, and Trello: Delete Webhook manage subscriptions; they are not triggers by themselves. To receive events, create a Mattering Automations inbound webhook trigger and pass its URL as the callback in Trello: Create Webhook: Trello then POSTs every action on the watched board, list, or card to it. At creation Trello sends an HTTP HEAD request to the callback and requires a 200 response, failed deliveries are retried three times, a callback answering 410 deletes the webhook, and sustained failure disables it.
Troubleshooting
Test Connection fails
Nodes return 401 after working before
Requests fail with 429 responses
Updating a card wiped its labels or members
Trello: Create Webhook fails at creation
A webhook went quiet
Trello: Update Check Item returns a 404
Add Check Item is refused when setting a due date or assignee
Related
The Trello MCP
What connecting Trello unlocks for AI agents and automations, with common uses and FAQs.
More guides
All Automations documentation
Every integration guide, plus how connectors, credentials, and workflows fit together.
Trello is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.