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

# Let AI Agents Manage Trello Boards and Cards

> Let agents read Trello boards and lists, and create or update cards. Connect in one click on OneCLI Cloud, and the gateway keeps the token from the agent.

## 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).

## What you will set up

* A Trello connection, one click on OneCLI Cloud
* Automatic token injection on every Trello request
* Per-agent, per-tool access, with approval for deleting cards

## Connect Trello

**1. Click Connect**

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

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

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](/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](/docs/guides/rules.md) add guardrails on top. A blocked request never reaches Trello.

To disconnect, remove the connection in **Settings** > **Apps** > **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 **Settings** > **Apps** > **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/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/trello/01-provider-allowed-origins.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=d9bd3cb30727c729715b191ebce248e5)
>
> 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/onecli-sh-docs/sLClq-IdqwxvWct5/images/integrations/trello/onecli-custom-credentials-trello.png?fit=max\&auto=format\&n=sLClq-IdqwxvWct5\&q=85\&s=fae6a0fbdffd15c5ad7f1053c3bfe11b)
>
> 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**.

## FAQ

> [accordion] Do I need a Trello API key?
>
> Not on OneCLI Cloud. Self-hosted, you add your own Trello Power-Up key first. See [Self-hosted](#self-hosted).

> [accordion] Does the agent see my Trello token?
>
> No. The token stays in OneCLI, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] How do I revoke Trello access?
>
> Remove the connection in **Settings** > **Apps** > **Trello**, then revoke OneCLI in Trello under **Settings** > **Applications**.


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