Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-v1.agno.com/llms.txt

Use this file to discover all available pages before exploring further.

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