productivity
Trello CLI for AI Agents
Use the Trello CLI from KosmoKrator to call Trello tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.Trello CLI Setup
Trello can be configured headlessly with `kosmokrator integrations:configure trello`.
# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
# Configure and verify this integration.
kosmokrator integrations:configure trello --set access_token="$TRELLO_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor trello --json
kosmokrator integrations:status --json Credentials
Authentication type: Bearer token bearer_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.
| Key | Env var | Type | Required | Label |
|---|---|---|---|---|
access_token | TRELLO_ACCESS_TOKEN | Secret secret | yes | Access Token |
url | TRELLO_URL | URL url | no | API Base URL |
Command Patterns
The generic command is stable across every integration. The provider shortcut is shorter for humans.
kosmo integrations:call trello.trello_list_boards '{"filter":"example_filter","fields":"example_fields","limit":1}' --json kosmo integrations:trello trello_list_boards '{"filter":"example_filter","fields":"example_fields","limit":1}' --json Discovery
These commands return structured output for coding agents that need to inspect capabilities before choosing a function.
kosmo integrations:docs trello --json
kosmo integrations:docs trello.trello_list_boards --json
kosmo integrations:schema trello.trello_list_boards --json
kosmo integrations:search "Trello" --json
kosmo integrations:list --json Automation Contexts
The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.
CLI Functions
Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.
trello.trello_list_boards
List all boards for the authenticated Trello member. Supports filtering by status and field selection.
read - Parameters
- filter, fields, limit
kosmo integrations:call trello.trello_list_boards '{"filter":"example_filter","fields":"example_fields","limit":1}' --json kosmo integrations:trello trello_list_boards '{"filter":"example_filter","fields":"example_fields","limit":1}' --json trello.trello_get_board
Get detailed information about a Trello board by ID.
read - Parameters
- id
kosmo integrations:call trello.trello_get_board '{"id":"example_id"}' --json kosmo integrations:trello trello_get_board '{"id":"example_id"}' --json trello.trello_list_lists
List all lists on a Trello board.
read - Parameters
- board_id
kosmo integrations:call trello.trello_list_lists '{"board_id":"example_board_id"}' --json kosmo integrations:trello trello_list_lists '{"board_id":"example_board_id"}' --json trello.trello_get_list
Get detailed information about a Trello list by ID.
read - Parameters
- id
kosmo integrations:call trello.trello_get_list '{"id":"example_id"}' --json kosmo integrations:trello trello_get_list '{"id":"example_id"}' --json trello.trello_list_cards
List all cards in a Trello list. Supports limit and before cursor for pagination.
read - Parameters
- list_id, limit, before
kosmo integrations:call trello.trello_list_cards '{"list_id":"example_list_id","limit":1,"before":"example_before"}' --json kosmo integrations:trello trello_list_cards '{"list_id":"example_list_id","limit":1,"before":"example_before"}' --json trello.trello_create_card
Create a new card on a Trello list.
write - Parameters
- name, id_list, desc, id_labels, id_members, due, pos
kosmo integrations:call trello.trello_create_card '{"name":"example_name","id_list":"example_id_list","desc":"example_desc","id_labels":"example_id_labels","id_members":"example_id_members","due":"example_due","pos":"example_pos"}' --json kosmo integrations:trello trello_create_card '{"name":"example_name","id_list":"example_id_list","desc":"example_desc","id_labels":"example_id_labels","id_members":"example_id_members","due":"example_due","pos":"example_pos"}' --json trello.trello_get_current_user
Get the profile of the currently authenticated Trello user. Useful for verifying credentials and displaying account information.
read - Parameters
- none
kosmo integrations:call trello.trello_get_current_user '{}' --json kosmo integrations:trello trello_get_current_user '{}' --json Function Schemas
Use these parameter tables when building CLI payloads without calling integrations:schema first.
trello.trello_list_boards 3 parameters
kosmo integrations:schema trello.trello_list_boards --json | Parameter | Type | Required | Description |
|---|---|---|---|
filter | string | no | Filter: "all", "closed", "members", "open", "organization", "public" (default: "all"). |
fields | string | no | Comma-separated board fields to return (default: "all"). |
limit | integer | no | Max number of boards to return (1–1000). |
trello.trello_get_board 1 parameters
kosmo integrations:schema trello.trello_get_board --json | Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The board ID. |
trello.trello_list_lists 1 parameters
kosmo integrations:schema trello.trello_list_lists --json | Parameter | Type | Required | Description |
|---|---|---|---|
board_id | string | yes | The board ID to list lists from. |
trello.trello_get_list 1 parameters
kosmo integrations:schema trello.trello_get_list --json | Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The list ID. |
trello.trello_list_cards 3 parameters
kosmo integrations:schema trello.trello_list_cards --json | Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | yes | The list ID. |
limit | integer | no | Max number of cards to return (1–1000). |
before | string | no | Card ID to fetch cards before (for pagination). |
trello.trello_create_card 7 parameters
kosmo integrations:schema trello.trello_create_card --json | Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Name for the card. |
id_list | string | yes | ID of the list to add the card to. |
desc | string | no | Description (supports Markdown). |
id_labels | array | no | Array of label IDs to add. |
id_members | array | no | Array of member IDs to assign. |
due | string | no | Due date in ISO 8601 format. |
pos | string | no | Position: "top", "bottom", or a positive number. |
trello.trello_get_current_user 0 parameters
kosmo integrations:schema trello.trello_get_current_user --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
Permissions
Headless calls still follow the integration read/write permission policy. Configure read/write defaults with
integrations:configure. Add --force only for trusted automation that should bypass that policy.