> ## Documentation Index
> Fetch the complete documentation index at: https://onecli.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Trello Boards, Lists, and Cards

> Read Trello boards, lists, and cards, and create or update cards and lists. Connect in one click on OneCLI Cloud, with no API key to manage.

## Overview

OneCLI connects AI agents to [Trello](https://trello.com). Agents can read boards, lists, and cards, and create or update cards and lists. The gateway injects the token into every request, so your agent never sees it.

On OneCLI Cloud, connecting takes one click. Self-hosted, you first add your own Trello Power-Up key (see the bottom of this page).

## Connect Trello

**1. Click Connect**

In the OneCLI dashboard, open **Connections** > **Trello** and click **Connect Trello**.

![OneCLI connect window for Trello, showing the setup guide link and the Connect to Trello button.](https://mintcdn.com/chartdbinc/yFw2bbdvTPdZgMOT/images/integrations/trello/onecli-connect-trello.png?fit=max\&auto=format\&n=yFw2bbdvTPdZgMOT\&q=85\&s=af6f26af68cdcab7ec13e06c2f8cb8d1)

The Trello connect window in OneCLI.

**2. Allow in Trello**

Sign in to Trello and click **Allow**. You're done.

## What agents can do

| Area | What agents can do |
| - | - |
| **Boards** | List and read boards. Create boards |
| **Lists** | Read a board's lists. Create lists |
| **Cards** | Read cards. Create, update, and delete cards |

## Controlling access

[Grant](https://onecli.sh/docs/guides/agent-access.md) the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what's blocked. Put **Delete card** behind approval. Organization [rules](https://onecli.sh/docs/guides/rules.md) add guardrails on top. A blocked request never reaches Trello.

To disconnect, remove the connection in **Connections** > **Trello**, then revoke OneCLI in Trello under **Settings** > **Applications**.

***

## Self-hosted: use your own Trello key

> [!NOTE]
>
> **Skip this section on OneCLI Cloud.** Self-hosted OneCLI needs either `TRELLO_API_KEY` and `TRELLO_API_SECRET` on the server, or your own key added below.

> [accordion] 1. Create a Power-Up
>
> Open [trello.com/power-ups/admin](https://trello.com/power-ups/admin), create a new Power-Up named `OneCLI`, then open **API key** and generate a key.

> [accordion] 2. Allow the OneCLI origin
>
> In OneCLI, open **Connections** > **Trello** > **Custom credentials** and copy the **Redirect URI**. Add its origin to the Power-Up's **Allowed origins**.
>
> ![Trello Power-Up admin, API key page for a Power-Up named OneCLI, with https://onecli.example.com entered under Allowed origins and the API key and secret hidden.](https://mintcdn.com/chartdbinc/dTUFGeS6j-vov2tm/images/integrations/trello/01-provider-allowed-origins.png?fit=max\&auto=format\&n=dTUFGeS6j-vov2tm\&q=85\&s=ab1f7c315eaaee244c1cea76ec2035e5)
>
> Add the OneCLI origin under Allowed origins on the Power-Up's API key page.
>
> ![OneCLI Custom credentials card for Trello with the setup guide link, the Redirect URI and its copy button, and the API key and secret fields.](https://mintcdn.com/chartdbinc/yFw2bbdvTPdZgMOT/images/integrations/trello/onecli-custom-credentials-trello.png?fit=max\&auto=format\&n=yFw2bbdvTPdZgMOT\&q=85\&s=dd9fdf60dd8d7b0b7aab90551040de3e)
>
> Copy the Redirect URI from Custom credentials in OneCLI.

> [accordion] 3. Connect with your key
>
> Copy the **API Key** and **Secret** into **Custom credentials**, turn it on, then click **Connect Trello**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.