Trello

Agno TrelloTools helps to integrate Trello functionalities into your agents, enabling management of boards, lists, and cards.

Prerequisites

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

uv 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()],
    )

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

Function	Description
create_card	Creates a new card in a specified board and list.
get_board_lists	Retrieves all lists on a specified Trello board.
move_card	Moves a card to a different list.
get_cards	Retrieves all cards from a specified list.
create_board	Creates a new Trello board.
create_list	Creates a new list on a specified board.
list_boards	Lists all Trello boards accessible by the authenticated user.

Toolkit Params

Parameter	Type	Default	Description
api_key	Optional[str]	None	Trello API key. If not provided, uses TRELLO_API_KEY environment variable.
api_secret	Optional[str]	None	Trello API secret. If not provided, uses TRELLO_API_SECRET environment variable.
token	Optional[str]	None	Trello token. If not provided, uses TRELLO_TOKEN environment variable.

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

You can use include_tools or exclude_tools to modify the list of tools the agent has access to. Learn more about selecting tools.

Developer Resources

• View Tools Source