Trello

Prerequisites

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

uv pip install -U py-trello openai

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.

cookbook/91_tools/trello_tools.py

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.

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

Tools Source

Todoist TwelveLabs

⌘I

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Prerequisites

Example

Toolkit Functions

Toolkit Params

Developer Resources

​Prerequisites

​Example

​Toolkit Functions

​Toolkit Params

​Board Filter Options for list_boards

​Developer Resources

Prerequisites

Example

Toolkit Functions

Toolkit Params

Board Filter Options for `list_boards`

Developer Resources