Docs/Integrations/Trello
Integrations

Trello

The trello tool lets the agent work with Trello boards, lists, and cards, authenticated with a Trello API key + token pair supplied via config or environment variables.

Tool

ToolActions
trellolist_boards, list_lists, list_cards, get_card, create_card, update_card, add_comment, archive_card, search

Key params:

ParamUsed byNotes
board_idlist_lists, list_cardsBoard identifier
list_idlist_cards, create_cardList identifier
card_idget_card, update_card, add_comment, archive_cardCard identifier
namecreate_card, update_cardCard name
descriptioncreate_card, update_cardCard description
commentadd_commentComment text
querysearchSearch query
due_datecreate_card, update_cardDue date (ISO format)
labelscreate_card, update_cardComma-separated label IDs

The key and token are sent as key and token query parameters on each Trello REST call.

Configuration

The tool registers when both the API key and token are present. Config keys:

{
  "integrations": {
    "trello": {
      "apiKey": "...",
      "token": "..."
    }
  }
}

Environment fallback

If the config values are empty, the tool falls back to environment variables:

Env varMaps to
TRELLO_API_KEYintegrations.trello.apiKey
TRELLO_TOKENintegrations.trello.token

Getting key + token

Generate both from the Trello developer page at https://trello.com/app-key β€” the API key is shown there, and the manual token is generated from the same page.

Setup

Run the interactive integrations setup and pick Trello:

flowly setup tools

The Trello card prompts for the key and token, validates them with a probe, and writes integrations.trello.apiKey / integrations.trello.token.

The integration needs a gateway restart to take effect (handled by setup, or run

flowly service restart).