​
Prerequisites

The following examples require the trello library and Trello API credentials which can be obtained by following Trello’s developer documentation.

pip install -U trello

Set the following environment variables:

export TRELLO_API_KEY="YOUR_API_KEY"
export TRELLO_API_SECRET="YOUR_API_SECRET"
export TRELLO_TOKEN="YOUR_TOKEN"

​
Example

The following agent will create a board called ai-agent and inside it create list called todo and doing and inside each of them create card called create agent.

from agno.agent import Agent
from agno.tools.trello import TrelloTools

agent = Agent(
    instructions=[
        "You are a Trello management assistant that helps organize and manage Trello boards, lists, and cards",
        "Help users with tasks like:",
        "- Creating and organizing boards, lists, and cards",
        "- Moving cards between lists",
        "- Retrieving board and list information",
        "- Managing card details and descriptions",
        "Always confirm successful operations and provide relevant board/list/card IDs and URLs",
        "When errors occur, provide clear explanations and suggest solutions",
    ],
    tools=[TrelloTools()],
    show_tool_calls=True,
)

agent.print_response(
    "Create a board called ai-agent and inside it create list called 'todo' and 'doing' and inside each of them create card called 'create agent'",
    stream=True,
)

​
Toolkit Functions

FunctionDescription
create_cardCreates a new card in a specified board and list.
get_board_listsRetrieves all lists on a specified Trello board.
move_cardMoves a card to a different list.
get_cardsRetrieves all cards from a specified list.
create_boardCreates a new Trello board.
create_listCreates a new list on a specified board.
list_boardsLists all Trello boards accessible by the authenticated user.

​
Toolkit Parameters

These parameters are passed to the TrelloTools constructor.

ParameterTypeDefaultDescription
api_keyOptional[str]NoneTrello API key. Defaults to TRELLO_API_KEY environment variable.
api_secretOptional[str]NoneTrello API secret. Defaults to TRELLO_API_SECRET environment variable.
tokenOptional[str]NoneTrello token. Defaults to TRELLO_TOKEN environment variable.
create_cardboolTrueEnable the create_card tool.
get_board_listsboolTrueEnable the get_board_lists tool.
move_cardboolTrueEnable the move_card tool.
get_cardsboolTrueEnable the get_cards tool.
create_boardboolTrueEnable the create_board tool.
create_listboolTrueEnable the create_list tool.
list_boardsboolTrueEnable the list_boards tool.

​
Board Filter Options for list_boards

The list_boards function accepts a board_filter argument with the following options:

  • all (default)
  • open
  • closed
  • organization
  • public
  • starred

​
Developer Resources