> ## 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 Integration: Boards, Lists & Cards for AI Agents

> Agents can read Trello boards and lists, and create or update cards. Connect in one click on OneCLI Cloud.

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

<Steps>
  <Step title="Click Connect">
    In the OneCLI dashboard, open **Connections** > **Trello** and click **Connect Trello**.

    <Frame caption="The Trello connect window in OneCLI.">
      <img src="https://mintcdn.com/chartdbinc/yFw2bbdvTPdZgMOT/images/integrations/trello/onecli-connect-trello.png?fit=max&auto=format&n=yFw2bbdvTPdZgMOT&q=85&s=af6f26af68cdcab7ec13e06c2f8cb8d1" alt="OneCLI connect window for Trello, showing the setup guide link and the Connect to Trello button." width="1056" height="1078" data-path="images/integrations/trello/onecli-connect-trello.png" />
    </Frame>
  </Step>

  <Step title="Allow in Trello">
    Sign in to Trello and click **Allow**. You're done.
  </Step>
</Steps>

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

***

<a id="self-hosted" style={{ scrollMarginTop: "8rem" }} />

## Self-hosted: use your own Trello key

<Info>
  **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.
</Info>

<AccordionGroup>
  <Accordion title="1. Create a Power-Up" defaultOpen>
    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>

  <Accordion title="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**.

    <Frame caption="Copy the Redirect URI from Custom credentials in OneCLI.">
      <img src="https://mintcdn.com/chartdbinc/yFw2bbdvTPdZgMOT/images/integrations/trello/onecli-custom-credentials-trello.png?fit=max&auto=format&n=yFw2bbdvTPdZgMOT&q=85&s=dd9fdf60dd8d7b0b7aab90551040de3e" alt="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." width="1932" height="1060" data-path="images/integrations/trello/onecli-custom-credentials-trello.png" />
    </Frame>
  </Accordion>

  <Accordion title="3. Connect with your key">
    Copy the **API Key** and **Secret** into **Custom credentials**, turn it on, then click **Connect Trello**.
  </Accordion>
</AccordionGroup>


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