# Trello — Pipedream Connect

> Trello is the flexible work management tool that empowers all teams to plan, track, and accomplish their work, their way.

- API slug: `trello` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Productivity
- Website: https://trello.com
- Managed OAuth scopes: `read` · `write`
- This page (HTML): https://pipedream.com/apps/trello
- Tools: 35 actions · 14 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: trello`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "trello",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Attachment To Card:
const result = await mcp.callTool({
  name: "trello-add-attachment-to-card",
  arguments: {
    board: "Board",
    cardId: "Card",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "trello-add-attachment-to-card",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    trello: { authProvisionId: "apn_xxxxxxx" },
    board: "Board",
    cardId: "Card",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (35)

### `trello-add-attachment-to-card` — Add Attachment To Card (Write)

Adds a file attachment on a card. See the documentation

Full schema: https://pipedream.com/apps/trello/actions/add-attachment-to-card.md

### `trello-add-checklist` — Add Checklist (Write)

Adds a new checklist to a card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/add-checklist.md

### `trello-add-comment` — Add Comment (Write)

Create a new comment on a specific card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/add-comment.md

### `trello-add-existing-label-to-card` — Add Existing Label to Card (Write)

Adds an existing label to the specified card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/add-existing-label-to-card.md

### `trello-add-member-to-card` — Add Member to Card (Write)

Adds a member to the specified card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/add-member-to-card.md

### `trello-archive-card` — Archive Card (Write)

Archives a card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/archive-card.md

### `trello-complete-checklist-item` — Complete a Checklist Item (Write)

Completes an existing checklist item in a card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/complete-checklist-item.md

### `trello-create-board` — Create a Board (Write)

Create a new Trello board or copy from an existing one. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/create-board.md

### `trello-create-checklist-item` — Create a Checklist Item (Write)

Creates a new checklist item in a card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/create-checklist-item.md

### `trello-create-list` — Create a List (Write)

Creates a new list. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/create-list.md

### `trello-create-card` — Create Card (Write)

Creates a new card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/create-card.md

### `trello-create-label` — Create Label (Write)

Creates a new label on the specified board. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/create-label.md

### `trello-delete-checklist` — Delete Checklist (Write)

Deletes the specified checklist. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/delete-checklist.md

### `trello-delete-checklist-item` — Delete Checklist Item (Write)

Deletes a checklist item from a card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/delete-checklist-item.md

### `trello-find-labels` — Find a Label (Read-only)

Finds a label on a specific board by name. See the documentation

Full schema: https://pipedream.com/apps/trello/actions/find-labels.md

### `trello-find-list` — Find a List (Read-only)

Finds a list on a specific board by name. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/find-list.md

### `trello-get-board` — Get Board (Read-only)

Request a single board. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/get-board.md

### `trello-get-card` — Get Card (Read-only)

Gets a card by its ID. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/get-card.md

### `trello-get-card-checklists` — Get Card Checklists (Read-only)

Gets the checklists on a card, including checklist items. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/get-card-checklists.md

### `trello-get-card-comments` — Get Card Comments (Read-only)

Gets the comments on a card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/get-card-comments.md

### `trello-get-cards-in-list` — Get Cards In A List (Read-only)

List the cards in a list. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/get-cards-in-list.md

### `trello-get-cards-on-board` — Get Cards On A Board (Read-only)

Get all of the open Cards on a Board. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/get-cards-on-board.md

### `trello-get-list` — Get List (Read-only)

Get information about a List. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/get-list.md

### `trello-get-member` — Get Member (Read-only)

Gets a member by their ID. See the documentation

Full schema: https://pipedream.com/apps/trello/actions/get-member.md

### `trello-list-boards` — List Boards (Read-only)

Lists the boards that the user is a member of. See the documentation

Full schema: https://pipedream.com/apps/trello/actions/list-boards.md

### `trello-list-id-organizations-options` — List Organization IDs Options (Read-only)

Retrieves available options for the Organization IDs field.

Full schema: https://pipedream.com/apps/trello/actions/list-id-organizations-options.md

### `trello-move-card-to-list` — Move Card to List (Read-only)

Moves a card to the specified board/list pair. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/move-card-to-list.md

### `trello-remove-label-from-card` — Remove Card Label (Write)

Removes label from card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/remove-label-from-card.md

### `trello-rename-list` — Rename List (Write)

Renames an existing list. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/rename-list.md

### `trello-search-boards` — Search Boards (Read-only)

Searches for boards matching the specified query. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/search-boards.md

### `trello-search-cards` — Search Cards (Read-only)

Searches for cards matching the specified query. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/search-cards.md

### `trello-search-checklists` — Search Checklists (Read-only)

Find a checklist on a particular board or card by name. See the documentation here and here.

Full schema: https://pipedream.com/apps/trello/actions/search-checklists.md

### `trello-search-members` — Search Members (Read-only)

Search for Trello members. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/search-members.md

### `trello-update-card` — Update Card (Write)

Updates a card. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/update-card.md

### `trello-update-checklist-item` — Update Checklist Item (Write)

Updates an existing checklist item on a card, including renaming, completing, or uncompleting the item. Updates to due, dueReminder, and idMember require Trello Premium (advanced checklists) and may not persist on free workspaces. See the documentation.

Full schema: https://pipedream.com/apps/trello/actions/update-checklist-item.md

## Triggers (14)

### `trello-card-moved` — Card Moved (Instant) (Instant)

Emit new event each time a card is moved to a list.

Full schema: https://pipedream.com/apps/trello/triggers/card-moved.md

### `trello-new-card` — New Card (Instant) (Instant)

Emit new event for each new Trello card on a board.

Full schema: https://pipedream.com/apps/trello/triggers/new-card.md

### `trello-card-updates` — Card Updated (Instant) (Instant)

Emit new event for each update to a Trello card.

Full schema: https://pipedream.com/apps/trello/triggers/card-updates.md

### `trello-new-label-added-to-card` — New Label Added To Card (Instant) (Instant)

Emit new event for each label added to a card.

Full schema: https://pipedream.com/apps/trello/triggers/new-label-added-to-card.md

### `trello-new-notification` — New Notification (Polling)

Emit new event for each new Trello notification for the authenticated user.

Full schema: https://pipedream.com/apps/trello/triggers/new-notification.md

### `trello-new-member-on-card` — New Member on Card (Instant) (Instant)

Emit new event for each member that join in a card.

Full schema: https://pipedream.com/apps/trello/triggers/new-member-on-card.md

### `trello-card-archived` — Card Archived (Instant) (Instant)

Emit new event for each card archived.

Full schema: https://pipedream.com/apps/trello/triggers/card-archived.md

### `trello-custom-webhook-events` — Custom Webhook Events (Instant) (Instant)

Emit new events for activity matching a board, event types, lists and/or cards.

Full schema: https://pipedream.com/apps/trello/triggers/custom-webhook-events.md

### `trello-new-attachment` — New Attachment (Instant) (Instant)

Emit new event when a new attachment is added on a board.

Full schema: https://pipedream.com/apps/trello/triggers/new-attachment.md

### `trello-new-board` — New Board (Instant) (Instant)

Emit new event for each new board added.

Full schema: https://pipedream.com/apps/trello/triggers/new-board.md

### `trello-new-activity` — New Board Activity (Instant) (Instant)

Emit new event for new activity on a board.

Full schema: https://pipedream.com/apps/trello/triggers/new-activity.md

### `trello-new-checklist` — New Checklist (Instant) (Instant)

Emit new event for each new checklist added to a board.

Full schema: https://pipedream.com/apps/trello/triggers/new-checklist.md

### `trello-new-comment-added-to-card` — New Comment Added to Card (Instant) (Instant)

Emit new event for each new comment added to a card.

Full schema: https://pipedream.com/apps/trello/triggers/new-comment-added-to-card.md

### `trello-new-label` — New Label Created (Instant) (Instant)

Emit new event for each new label added to a board.

Full schema: https://pipedream.com/apps/trello/triggers/new-label.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt