Trello

Manage Trello lists, cards, and activity

Trello is a visual collaboration tool that helps you organize projects, tasks, and workflows using boards, lists, and cards.

With Trello in Sim, you can:

  • List boards and lists: View the boards you have access to and their associated lists.
  • List and search cards: Retrieve all cards on a board or filter by list to see their content and status.
  • Create cards: Add new cards to a Trello list, including descriptions, labels, and due dates.
  • Update and move cards: Edit card properties, move cards across lists, and set due dates or labels.
  • Get recent activity: Retrieve actions and activity history for boards and cards.
  • Comment on cards: Add comments to cards for collaboration and tracking.

Integrating Trello with Sim empowers your agents to manage your team’s tasks, boards, and projects programmatically. Automate project management workflows, keep task lists up-to-date, synchronize with other tools, or trigger intelligent workflows in response to Trello events—all through your AI agents.

Usage Instructions

Trello OAuth Setup

Before connecting Trello in Sim, add your Sim app origin to the Allowed Origins list for your Trello API key in the Trello Power-Up admin settings.

Trello's authorization flow redirects back to Sim using a return_url. If your Sim origin is not whitelisted in Trello, Trello will block the redirect and the connection flow will fail before Sim can save the token.

Integrate with Trello to list board lists, list cards, create cards, update cards, review activity, and add comments.

Tools

trello_list_lists

List all lists on a Trello board

Input

ParameterTypeRequiredDescription
boardIdstringYesTrello board ID (24-character hex string)

Output

ParameterTypeDescription
listsarrayLists on the selected board
idstringList ID
namestringList name
closedbooleanWhether the list is archived
posnumberList position on the board
idBoardstringBoard ID containing the list
countnumberNumber of lists returned

trello_list_cards

List cards from a Trello board or list

Input

ParameterTypeRequiredDescription
boardIdstringNoTrello board ID to list open cards from. Provide either boardId or listId
listIdstringNoTrello list ID to list cards from. Provide either boardId or listId

Output

ParameterTypeDescription
cardsarrayCards returned from the selected Trello board or list
idstringCard ID
namestringCard name
descstringCard description
urlstringFull card URL
idBoardstringBoard ID containing the card
idListstringList ID containing the card
closedbooleanWhether the card is archived
labelIdsarrayLabel IDs applied to the card
labelsarrayLabels applied to the card
idstringLabel ID
namestringLabel name
colorstringLabel color
duestringCard due date in ISO 8601 format
dueCompletebooleanWhether the due date is complete
countnumberNumber of cards returned

trello_create_card

Create a new card in a Trello list

Input

ParameterTypeRequiredDescription
listIdstringYesTrello list ID (24-character hex string)
namestringYesName/title of the card
descstringNoDescription of the card
posstringNoPosition of the card (top, bottom, or positive float)
duestringNoDue date (ISO 8601 format)
dueCompletebooleanNoWhether the due date should be marked complete
labelIdsarrayNoLabel IDs to attach to the card
itemsstringNoA Trello label ID

Output

ParameterTypeDescription
cardjsonCreated card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete)
idstringCard ID
namestringCard name
descstringCard description
urlstringFull card URL
idBoardstringBoard ID containing the card
idListstringList ID containing the card
closedbooleanWhether the card is archived
labelIdsarrayLabel IDs applied to the card
labelsarrayLabels applied to the card
idstringLabel ID
namestringLabel name
colorstringLabel color
duestringCard due date in ISO 8601 format
dueCompletebooleanWhether the due date is complete

trello_update_card

Update an existing card on Trello

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID (24-character hex string)
namestringNoNew name/title of the card
descstringNoNew description of the card
closedbooleanNoArchive/close the card (true) or reopen it (false)
idListstringNoTrello list ID to move card to (24-character hex string)
duestringNoDue date (ISO 8601 format)
dueCompletebooleanNoMark the due date as complete

Output

ParameterTypeDescription
cardjsonUpdated card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete)
idstringCard ID
namestringCard name
descstringCard description
urlstringFull card URL
idBoardstringBoard ID containing the card
idListstringList ID containing the card
closedbooleanWhether the card is archived
labelIdsarrayLabel IDs applied to the card
labelsarrayLabels applied to the card
idstringLabel ID
namestringLabel name
colorstringLabel color
duestringCard due date in ISO 8601 format
dueCompletebooleanWhether the due date is complete

trello_get_actions

Get activity/actions from a board or card

Input

ParameterTypeRequiredDescription
boardIdstringNoTrello board ID (24-character hex string). Either boardId or cardId required
cardIdstringNoTrello card ID (24-character hex string). Either boardId or cardId required
filterstringNoFilter actions by type (e.g., "commentCard,updateCard,createCard" or "all")
limitnumberNoMaximum number of board actions to return
pagenumberNoPage number for action results

Output

ParameterTypeDescription
actionsarrayAction items (id, type, date, idMemberCreator, text, memberCreator, card, board, list)
idstringAction ID
typestringAction type
datestringAction timestamp
idMemberCreatorstringID of the member who created the action
textstringComment text when present
memberCreatorobjectMember who created the action
idstringMember ID
fullNamestringMember full name
usernamestringMember username
cardobjectCard referenced by the action
idstringCard ID
namestringCard name
shortLinkstringShort card link
idShortnumberBoard-local card number
duestringCard due date
boardobjectBoard referenced by the action
idstringBoard ID
namestringBoard name
shortLinkstringShort board link
listobjectList referenced by the action
idstringList ID
namestringList name
countnumberNumber of actions returned

trello_add_comment

Add a comment to a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID (24-character hex string)
textstringYesComment text

Output

ParameterTypeDescription
commentjsonCreated comment action (id, type, date, idMemberCreator, text, memberCreator, card, board, list)
idstringAction ID
typestringAction type
datestringAction timestamp
idMemberCreatorstringID of the member who created the comment
textstringComment text
memberCreatorobjectMember who created the comment
idstringMember ID
fullNamestringMember full name
usernamestringMember username
cardobjectCard referenced by the comment
idstringCard ID
namestringCard name
shortLinkstringShort card link
idShortnumberBoard-local card number
duestringCard due date
boardobjectBoard referenced by the comment
idstringBoard ID
namestringBoard name
shortLinkstringShort board link
listobjectList referenced by the comment
idstringList ID
namestringList name

On this page