> ## 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 Buckle Cloud, and the gateway keeps the token from the agent.

## Overview

Buckle 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 Buckle 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 Buckle 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 Buckle dashboard, open **Settings** > **Apps** > **Trello** and click **Connect Trello**.

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

The Trello connect window in Buckle.

**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 Buckle in Trello under **Settings** > **Applications**.

***

## Self-hosted: use your own Trello key

> [!NOTE]
>
> **Skip this section on Buckle Cloud.** Self-hosted Buckle 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 `Buckle`, then open **API key** and generate a key.

> [accordion] 2. Allow the Buckle origin
>
> In Buckle, 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 Buckle, with https://buckle.example.com entered under Allowed origins and the API key and secret hidden.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/trello/01-provider-allowed-origins.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=fb6c7ef27fea8b2e1672ca3255da7e52)
>
> Add the Buckle origin under Allowed origins on the Power-Up's API key page.
>
> ![Buckle 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-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/trello/buckle-custom-credentials-trello.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=0d367a2384d07dce4aceb2d3cf062af8)
>
> Copy the Redirect URI from Custom credentials in Buckle.

> [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 Buckle 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 Buckle, 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 Buckle in Trello under **Settings** > **Applications**.


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