> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended**:
> ```bash
> npx @scalekit-inc/cli setup
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for 40+ agents.
> Features: full-stack-auth, agent-auth, mcp-auth, modular-sso, modular-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Trello connector

Connect to Trello. Manage boards, cards, lists, and team collaboration workflows

**Authentication:** OAuth 1.0a
**Categories:** Project Management, Collaboration, Productivity
1. ### Install the SDK

   
     ### Node.js

```bash frame="terminal"
npm install @scalekit-sdk/node
```

     ### Python

```bash frame="terminal"
pip install scalekit
```

   

   Full SDK reference: [Node.js](/agentkit/sdks/node/) | [Python](/agentkit/sdks/python/)

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

```sh showLineNumbers=false title=".env"
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```

3. ### Set up the connector

   Register your Trello credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

   ## Dashboard setup steps

Register your Trello API key and application name with Scalekit so it can authenticate and manage the OAuth 1.0a flow on your behalf.

1. ### Copy the redirect URI from Scalekit

   - In the [Scalekit dashboard](https://app.scalekit.com), go to **AgentKit** > **Connections** > **Create Connection**. Find **Trello** and click **Create**.

     > tip: Testing vs. production
>
> By default, Scalekit creates the connection using its own shared credentials. This works for testing. Before going to production, follow the steps below to use your own Trello app.

   - Click **Use your own credentials** and copy the redirect URI. It looks like `https:///sso/v1/oauth//callback`.

2. ### Create a Power-Up app in Trello

   - Sign in to [trello.com/power-ups/admin](https://trello.com/power-ups/admin) and click **New** to create an app (or open an existing one, for example `Agent Auth`).

     > Image: Trello Power-Ups admin Your Apps page showing an Agent Auth app

3. ### Add the redirect URI and copy your API Key

   - Open the app and go to the **API key** tab.
   - Under **Allowed origins**, paste the redirect URI you copied from Scalekit and click **Add**.
   - Copy the **API key** value — you'll use this as the `client_id` in Scalekit.

     > Image: Trello app API key page showing the API key field, Allowed origins, and Secret

     > note: Secret is optional for the proxy flow
>
> Trello's UI also shows a **Secret**, needed only if you implement OAuth 1.0a authorization yourself. Scalekit's Trello connection only requires the **API Key** and an **Application Name** — it handles the OAuth 1.0a signing for you.

4. ### Add credentials in Scalekit

   - Return to the connection you created in Scalekit and enter:
     - **API Key** — the API key you copied from Trello (used as `client_id`)
     - **Application Name** — the name shown to users on Trello's authorization page (for example, `Agent Auth`)
   - Click **Save**.

## What you can do

Connect this agent connector to let your agent:

- **Get board, board actions, board cards** — Get a Trello board by its ID, including optional fields, cards, lists, and members

## Common workflows

export const sectionTitle = 'Common workflows'

## Proxy API call

  ### Node.js

```typescript
const result = await actions.request({
  connectionName: 'trello',
  identifier: 'user_123',
  path: '/1/members/me',
  method: 'GET',
});
console.log(result);
```

  ### Python

```python
result = actions.request(
    connection_name='trello',
    identifier='user_123',
    path="/1/members/me",
    method="GET"
)
print(result)
```

## Execute a tool

  ### Node.js

```typescript
const result = await actions.executeTool({
  connector: 'trello',
  identifier: 'user_123',
  toolName: 'trello_list',
  toolInput: {},
});
console.log(result);
```

  ### Python

```python
result = actions.execute_tool(
    tool_input={},
    tool_name='trello_list',
    connection_name='trello',
    identifier='user_123',
)
print(result)
```

## Tool list

Use the exact tool names from the **Tool list** below when you call `execute_tool`. If you're not sure which name to use, list the tools available for the current user first.

## Tool list

### `trello_get_board`

Get a Trello board by its ID, including optional fields, cards, lists, and members.

Parameters:

- `id` (`string`, required): The ID of the board to retrieve
- `cards` (`string`, optional): Which cards to return
- `fields` (`string`, optional): Comma-separated list of board fields to return
- `lists` (`string`, optional): Which lists to return
- `members` (`string`, optional): Which members to return

### `trello_get_board_actions`

Get the activity log (actions) for a Trello board.

Parameters:

- `id` (`string`, required): The ID of the board
- `filter` (`string`, optional): Comma-separated list of action types to filter by
- `limit` (`integer`, optional): Maximum number of actions to return
- `page` (`integer`, optional): Page number for pagination

### `trello_get_board_cards`

Get all cards on a Trello board, optionally filtered by status.

Parameters:

- `id` (`string`, required): The ID of the board
- `fields` (`string`, optional): Comma-separated list of card fields to return
- `filter` (`string`, optional): Filter cards by status

### `trello_get_board_labels`

Get all labels defined on a Trello board.

Parameters:

- `id` (`string`, required): The ID of the board
- `fields` (`string`, optional): Comma-separated list of label fields to return
- `limit` (`integer`, optional): Maximum number of labels to return (0–1000)

### `trello_get_board_lists`

Get all lists on a Trello board, optionally filtered by status.

Parameters:

- `id` (`string`, required): The ID of the board
- `filter` (`string`, optional): Filter lists by status

### `trello_get_board_members`

Get all members of a Trello board, optionally filtered by role.

Parameters:

- `id` (`string`, required): The ID of the board
- `filter` (`string`, optional): Filter members by role


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
