CONNECT APP
Build with Trello
Productivity
- OAuth
MCP
Give your agent Trello tools
Every Trello action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Trello account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{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",
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{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",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Add Attachment To Card:
result = await session.call_tool("trello-add-attachment-to-card", {
"board": "Board",
"cardId": "Card",
})SDK
Run Trello actions from your backend
Connect a user's Trello account once, then run Add Attachment To Card on their behalf from your own code — TypeScript, Python, or plain HTTP.
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",
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="trello-add-attachment-to-card",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"trello": {"authProvisionId": "apn_xxxxxxx"},
"board": "Board",
"cardId": "Card",
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "trello-add-attachment-to-card",
"configured_props": {
"trello": { "authProvisionId": "apn_xxxxxxx" },
"board": "Board",
"cardId": "Card"
}
}'TOOLS
Trello actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Add Attachment To Card
actionAdds a file attachment on a card. See the documentationWritev1.0.9 -
Add Checklist
actionAdds a new checklist to a card. See the documentation.Writev0.2.7 -
Add Comment
actionCreate a new comment on a specific card. See the documentation.Writev0.2.7 -
Add Existing Label to Card
actionAdds an existing label to the specified card. See the documentation.Writev0.1.7 -
Add Member to Card
actionAdds a member to the specified card. See the documentation.Writev0.2.7 -
Archive Card
actionArchives a card. See the documentation.Writev0.2.7 -
Complete a Checklist Item
actionCompletes an existing checklist item in a card. See the documentation.Writev0.2.7 -
Create a Board
actionCreate a new Trello board or copy from an existing one. See the documentation.Writev0.2.8 -
Create a Checklist Item
actionCreates a new checklist item in a card. See the documentation.Writev0.3.5 -
Create a List
actionCreates a new list. See the documentation.Writev0.2.7 -
Create Card
actionCreates a new card. See the documentation.Writev1.0.9 -
Create Label
actionCreates a new label on the specified board. See the documentation.Writev0.2.8 -
Delete Checklist
actionDeletes the specified checklist. See the documentation.Writev0.2.7 -
Delete Checklist Item
actionDeletes a checklist item from a card. See the documentation.Writev0.0.1 -
Find a Label
actionFinds a label on a specific board by name. See the documentationRead-onlyv0.2.7 -
Find a List
actionFinds a list on a specific board by name. See the documentation.Read-onlyv0.2.7 -
Get Board
actionRequest a single board. See the documentation.Read-onlyv0.0.6 -
Get Card
actionGets a card by its ID. See the documentation.Read-onlyv0.4.0 -
Get Card Checklists
actionGets the checklists on a card, including checklist items. See the documentation.Read-onlyv0.0.2 -
Get Card Comments
actionGets the comments on a card. See the documentation.Read-onlyv0.0.1 -
Get Cards In A List
actionList the cards in a list. See the documentation.Read-onlyv0.0.5 -
Get Cards On A Board
actionGet all of the open Cards on a Board. See the documentation.Read-onlyv0.0.5 -
Get List
actionGet information about a List. See the documentation.Read-onlyv0.1.7 -
Get Member
actionGets a member by their ID. See the documentationRead-onlyv0.0.3 -
List Boards
actionLists the boards that the user is a member of. See the documentationRead-onlyv0.0.3 -
List Organization IDs Options
actionRetrieves available options for the Organization IDs field.Read-onlyv0.0.3 -
Move Card to List
actionMoves a card to the specified board/list pair. See the documentation.Read-onlyv0.2.7 -
Remove Card Label
actionRemoves label from card. See the documentation.Writev0.2.7 -
Rename List
actionRenames an existing list. See the documentation.Writev0.1.7 -
Search Boards
actionSearches for boards matching the specified query. See the documentation.Read-onlyv0.3.7 -
Search Cards
actionSearches for cards matching the specified query. See the documentation.Read-onlyv0.2.7 -
Search Checklists
actionFind a checklist on a particular board or card by name. See the documentation here and here.Read-onlyv0.2.7 -
Search Members
actionSearch for Trello members. See the documentation.Read-onlyv0.2.7 -
Update Card
actionUpdates a card. See the documentation.Writev0.2.7 -
Update Checklist Item
actionUpdates an existing checklist item on a card, including renaming, completing, or uncompleting the item. Updates todue,dueReminder, andidMemberrequire Trello Premium (advanced checklists) and may not persist on free workspaces. See the documentation.Writev0.0.2
-
Card Moved (Instant)
triggerEmit new event each time a card is moved to a list.Instantv0.1.6 -
New Card (Instant)
triggerEmit new event for each new Trello card on a board.Instantv0.1.6 -
Card Updated (Instant)
triggerEmit new event for each update to a Trello card.Instantv0.1.6 -
New Label Added To Card (Instant)
triggerEmit new event for each label added to a card.Instantv0.1.6 -
New Notification
triggerEmit new event for each new Trello notification for the authenticated user.v0.1.6 -
New Member on Card (Instant)
triggerEmit new event for each member that join in a card.Instantv0.1.6 -
Card Archived (Instant)
triggerEmit new event for each card archived.Instantv0.1.6 -
Custom Webhook Events (Instant)
triggerEmit new events for activity matching a board, event types, lists and/or cards.Instantv0.1.6 -
New Attachment (Instant)
triggerEmit new event when a new attachment is added on a board.Instantv0.1.6 -
New Board (Instant)
triggerEmit new event for each new board added.Instantv0.1.6 -
New Board Activity (Instant)
triggerEmit new event for new activity on a board.Instantv0.1.6 -
New Checklist (Instant)
triggerEmit new event for each new checklist added to a board.Instantv0.1.6 -
New Comment Added to Card (Instant)
triggerEmit new event for each new comment added to a card.Instantv0.2.6 -
New Label Created (Instant)
triggerEmit new event for each new label added to a board.Instantv0.1.6
MULTI-APP
Use Trello with other popular apps
Most products don't stop at one integration. Pair Trello with the other apps your users rely on, and ship use cases that span both.
- App slug
- trello
- Authentication
- OAuth
- Categories
- Productivity
- Actions
- 35
- Triggers
- 14
- API proxy
- Not available
OAuth scopes
These are the scopes Pipedream's managed Trello OAuth client requests when one of your users connects an account. Supply your own OAuth client to request a different set.
- read
- write