Trello

OpenCrabs integrates with Trello for board and card management via the trello_send tool.

Setup

Step 1: Get Trello Credentials

Go to trello.com/power-ups/admin
Create a new Power-Up to get your API Key
Click the “Token” link next to your API key to generate an API Token

Step 2: Configure via the Onboarding Wizard

Run /onboard:channels (or /onboard and navigate to the Channels step):

Use ↑/↓ to focus Trello
Press Space to toggle it on
Press Enter to open the Trello setup screen
Fill in the fields:
- API Key — from the Trello Power-Up admin page
- API Token — generated alongside the API key
- Board ID — board name or 24-character hex ID (names are resolved automatically)
- Allowed Users — Trello member IDs allowed to interact with the bot (leave empty for all members)
Press Enter on Test Connection to verify board access
Press Enter to save

Manual Configuration (advanced)

# keys.toml
[channels.trello]
api_key = "your-api-key"
token = "your-token"

# config.toml
[channels.trello]
enabled = true
boards = ["Board Name or ID"]
allowed_users = []
# poll_interval_secs = 30  # Poll for new card comments

Tool Actions

The trello_send tool supports 22 actions:

Action	Description
`create_card`	Create a new card
`get_card`	Get card details
`update_card`	Update card fields
`move_card`	Move card to another list
`archive_card`	Archive a card
`find_cards`	Search for cards
`add_comment`	Add a comment to a card
`get_card_comments`	Read card comments
`add_checklist`	Add a checklist to a card
`add_checklist_item`	Add an item to a checklist
`complete_checklist_item`	Mark checklist item done
`add_label_to_card`	Add a label
`remove_label_from_card`	Remove a label
`add_member_to_card`	Assign a member
`remove_member_from_card`	Unassign a member
`add_attachment`	Attach a file or URL
`list_boards`	List accessible boards
`list_lists`	List columns in a board
`get_board_members`	Get board members
`search`	Search across boards
`get_notifications`	Get notifications
`mark_notifications_read`	Mark notifications read

Behavior

Tool-only by default — The agent acts on Trello only when explicitly asked
Optional polling — Set poll_interval_secs to enable monitoring for @bot_username mentions
Image attachments — Generated images are sent as card attachments with embedded previews
File attachments — Card attachments (images, documents) are fetched and processed through the vision pipeline

Keyboard shortcuts