Trello connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .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, go to AgentKit > Connections > Create Connection. Find Trello and click Create.

        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://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

   2. Create a Power-Up app in Trello

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

        

   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.

        

        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:

• Update list, label, checklist item — Rename, reposition, or archive/unarchive a Trello list
• Search records — Global keyword search across Trello boards, cards, members, and organizations that the authenticated user can access
• Card remove member from, remove label from, add member to — Remove a member from a Trello card
• List my boards — List the boards the authenticated user belongs to
• Get webhook, current member, checklist — Get a Trello webhook’s current details and status by ID
• Delete webhook, label, comment — Permanently delete a Trello webhook by its ID, stopping any further callbacks

Common workflows

Proxy API call

Node.js

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

Python

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

Execute a tool

Node.js

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

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.

trello_add_attachment_to_card#Attach a URL to a Trello card. Trello fetches the URL and shows a preview when it recognizes the link type (e.g. images, YouTube, Google Drive).3 params▾

Attach a URL to a Trello card. Trello fetches the URL and shows a preview when it recognizes the link type (e.g. images, YouTube, Google Drive).

NameTypeRequiredDescription

idstringrequiredThe ID of the card to attach the URL to

urlstringrequiredURL of the attachment

namestringoptionalDisplay name for the attachment

trello_add_checklist_item#Add a new item to a Trello checklist.4 params▾

Add a new item to a Trello checklist.

NameTypeRequiredDescription

idstringrequiredThe ID of the checklist to add the item to

namestringrequiredText of the checklist item

checkedbooleanoptionalWhether the item starts checked off

posstringoptionalPosition of the item in the checklist: top, bottom, or a positive number

trello_add_comment_to_card#Add a comment to a Trello card.2 params▾

Add a comment to a Trello card.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to comment on

textstringrequiredThe comment text

trello_add_label_to_card#Apply an existing board label to a Trello card. Use Get Board Labels or Create Label to find or create a label ID first.2 params▾

Apply an existing board label to a Trello card. Use Get Board Labels or Create Label to find or create a label ID first.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to label

idLabelstringrequiredThe ID of the label to add

trello_add_member_to_card#Assign a member to a Trello card.2 params▾

Assign a member to a Trello card.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to assign the member to

idMemberstringrequiredThe ID of the member to add

trello_create_board#Create a new Trello board.4 params▾

Create a new Trello board.

NameTypeRequiredDescription

namestringrequiredName of the board

defaultListsbooleanoptionalWhether to seed the board with the default To Do / Doing / Done lists

descstringoptionalDescription of the board

idOrganizationstringoptionalID of the Workspace (organization) to create the board in

trello_create_card#Create a new card on a Trello list.7 params▾

Create a new card on a Trello list.

NameTypeRequiredDescription

idListstringrequiredThe ID of the list to create the card in

descstringoptionalDescription of the card

duestringoptionalDue date for the card, ISO 8601 format

idLabelsstringoptionalComma-separated list of label IDs to apply to the card

idMembersstringoptionalComma-separated list of member IDs to assign to the card

namestringoptionalName (title) of the card

posstringoptionalPosition of the card in the list: top, bottom, or a positive number

trello_create_checklist#Create a new checklist on a Trello card.3 params▾

Create a new checklist on a Trello card.

NameTypeRequiredDescription

idCardstringrequiredThe ID of the card to add the checklist to

namestringrequiredName of the checklist

posstringoptionalPosition of the checklist on the card: top, bottom, or a positive number

trello_create_label#Create a new label on a Trello board. Use Add Label To Card afterward to apply it.3 params▾

Create a new label on a Trello board. Use Add Label To Card afterward to apply it.

NameTypeRequiredDescription

colorstringrequiredColor of the label

idBoardstringrequiredThe ID of the board to create the label on

namestringrequiredName of the label

trello_create_list#Create a new list on a Trello board.3 params▾

Create a new list on a Trello board.

NameTypeRequiredDescription

idBoardstringrequiredThe ID of the board to create the list on

namestringrequiredName of the list

posstringoptionalPosition of the list on the board: top, bottom, or a positive number

trello_create_webhook#Create a webhook that notifies a callback URL whenever a Trello board, card, list, or other model changes.4 params▾

Create a webhook that notifies a callback URL whenever a Trello board, card, list, or other model changes.

NameTypeRequiredDescription

callbackURLstringrequiredThe publicly reachable URL Trello will POST updates to

idModelstringrequiredThe ID of the board, card, list, or other model to watch

activebooleanoptionalWhether the webhook is active immediately

descriptionstringoptionalDescription of the webhook

trello_delete_attachment#Permanently delete an attachment from a Trello card. Complements Add Attachment To Card.2 params▾

Permanently delete an attachment from a Trello card. Complements Add Attachment To Card.

NameTypeRequiredDescription

idstringrequiredThe ID of the card the attachment belongs to

idAttachmentstringrequiredThe ID of the attachment to delete

trello_delete_card#Permanently delete a Trello card. This cannot be undone — to keep the card but hide it, use Update Card with closed=true instead.1 param▾

Permanently delete a Trello card. This cannot be undone — to keep the card but hide it, use Update Card with closed=true instead.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to delete

trello_delete_checklist#Permanently delete a Trello checklist. Complements Create Checklist.1 param▾

Permanently delete a Trello checklist. Complements Create Checklist.

NameTypeRequiredDescription

idstringrequiredThe ID of the checklist to delete

trello_delete_checklist_item#Remove a single item from a Trello checklist. Complements Add Checklist Item.2 params▾

Remove a single item from a Trello checklist. Complements Add Checklist Item.

NameTypeRequiredDescription

idstringrequiredThe ID of the checklist the item belongs to

idCheckItemstringrequiredThe ID of the checklist item to remove

trello_delete_comment#Delete a comment from a Trello card. Comments are represented as actions of type commentCard; pass that action's ID. Complements Add Comment To Card.2 params▾

Delete a comment from a Trello card. Comments are represented as actions of type commentCard; pass that action's ID. Complements Add Comment To Card.

NameTypeRequiredDescription

idstringrequiredThe ID of the card the comment belongs to

idActionstringrequiredThe ID of the comment action to delete

trello_delete_label#Permanently delete a Trello label from a board. This removes it from every card that uses it and cannot be undone.1 param▾

Permanently delete a Trello label from a board. This removes it from every card that uses it and cannot be undone.

NameTypeRequiredDescription

idstringrequiredThe ID of the label to delete

trello_delete_webhook#Permanently delete a Trello webhook by its ID, stopping any further callbacks.1 param▾

Permanently delete a Trello webhook by its ID, stopping any further callbacks.

NameTypeRequiredDescription

idstringrequiredThe ID of the webhook to delete

trello_get_board#Get a Trello board by its ID, including optional fields, cards, lists, and members.5 params▾

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

NameTypeRequiredDescription

idstringrequiredThe ID of the board to retrieve

cardsstringoptionalWhich cards to return

fieldsstringoptionalComma-separated list of board fields to return

listsstringoptionalWhich lists to return

membersstringoptionalWhich members to return

trello_get_board_actions#Get the activity log (actions) for a Trello board.4 params▾

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

NameTypeRequiredDescription

idstringrequiredThe ID of the board

filterstringoptionalComma-separated list of action types to filter by

limitintegeroptionalMaximum number of actions to return

pageintegeroptionalPage number for pagination

trello_get_board_cards#Get all cards on a Trello board, optionally filtered by status.3 params▾

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

NameTypeRequiredDescription

idstringrequiredThe ID of the board

fieldsstringoptionalComma-separated list of card fields to return

filterstringoptionalFilter cards by status

trello_get_board_labels#Get all labels defined on a Trello board.3 params▾

Get all labels defined on a Trello board.

NameTypeRequiredDescription

idstringrequiredThe ID of the board

fieldsstringoptionalComma-separated list of label fields to return

limitintegeroptionalMaximum number of labels to return (0–1000)

trello_get_board_lists#Get all lists on a Trello board, optionally filtered by status.2 params▾

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

NameTypeRequiredDescription

idstringrequiredThe ID of the board

filterstringoptionalFilter lists by status

trello_get_board_members#Get all members of a Trello board, optionally filtered by role.2 params▾

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

NameTypeRequiredDescription

idstringrequiredThe ID of the board

filterstringoptionalFilter members by role

trello_get_card#Get a Trello card by its ID.2 params▾

Get a Trello card by its ID.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to retrieve

fieldsstringoptionalComma-separated list of card fields to return

trello_get_checklist#Get a Trello checklist by its ID, including its check items.3 params▾

Get a Trello checklist by its ID, including its check items.

NameTypeRequiredDescription

idstringrequiredThe ID of the checklist to retrieve

checkItemsstringoptionalWhether to include check items in the response

fieldsstringoptionalComma-separated list of checklist fields to return

trello_get_current_member#Get the authenticated user's own Trello member info (profile, username, boards/organizations membership summary).1 param▾

Get the authenticated user's own Trello member info (profile, username, boards/organizations membership summary).

NameTypeRequiredDescription

fieldsstringoptionalComma-separated list of member fields to return

trello_get_webhook#Get a Trello webhook's current details and status by ID. Complements Create Webhook and Delete Webhook.1 param▾

Get a Trello webhook's current details and status by ID. Complements Create Webhook and Delete Webhook.

NameTypeRequiredDescription

idstringrequiredThe ID of the webhook to retrieve

trello_list_my_boards#List the boards the authenticated user belongs to. Use this to discover board IDs before calling other board, card, or list tools.2 params▾

List the boards the authenticated user belongs to. Use this to discover board IDs before calling other board, card, or list tools.

NameTypeRequiredDescription

fieldsstringoptionalComma-separated list of board fields to return

filterstringoptionalWhich boards to return

trello_remove_label_from_card#Remove a label from a Trello card. Complements Add Label To Card.2 params▾

Remove a label from a Trello card. Complements Add Label To Card.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to remove the label from

idLabelstringrequiredThe ID of the label to remove

trello_remove_member_from_card#Remove a member from a Trello card. Complements Add Member To Card.2 params▾

Remove a member from a Trello card. Complements Add Member To Card.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to remove the member from

idMemberstringrequiredThe ID of the member to remove

trello_search#Global keyword search across Trello boards, cards, members, and organizations that the authenticated user can access.9 params▾

Global keyword search across Trello boards, cards, members, and organizations that the authenticated user can access.

NameTypeRequiredDescription

querystringrequiredThe search query text

boards_limitintegeroptionalMaximum number of boards to return (max 1000)

card_fieldsstringoptionalComma-separated list of card fields to return

cards_limitintegeroptionalMaximum number of cards to return (max 1000)

idBoardsstringoptionalRestrict search to specific board IDs

idCardsstringoptionalRestrict search to specific card IDs

idOrganizationsstringoptionalRestrict search to specific Workspace (organization) IDs

modelTypesstringoptionalWhich model types to include in results

partialbooleanoptionalWhether to also match partial words

trello_update_card#Update a Trello card's name, description, due date, list, position, or archived state.7 params▾

Update a Trello card's name, description, due date, list, position, or archived state.

NameTypeRequiredDescription

idstringrequiredThe ID of the card to update

closedbooleanoptionalArchive (true) or unarchive (false) the card

descstringoptionalNew description for the card

duestringoptionalNew due date, ISO 8601 format. Pass an empty string to clear it.

idListstringoptionalID of the list to move the card to

namestringoptionalNew name (title) for the card

posstringoptionalNew position: top, bottom, or a positive number

trello_update_checklist_item#Update a checklist item's text or checked state. Trello scopes this update by both the card and the check item ID.4 params▾

Update a checklist item's text or checked state. Trello scopes this update by both the card and the check item ID.

NameTypeRequiredDescription

idCardstringrequiredThe ID of the card that owns the checklist

idCheckItemstringrequiredThe ID of the checklist item to update

namestringoptionalNew text for the checklist item

statestringoptionalChecked state of the item

trello_update_label#Rename or recolor an existing Trello label.3 params▾

Rename or recolor an existing Trello label.

NameTypeRequiredDescription

idstringrequiredThe ID of the label to update

colorstringoptionalNew color for the label

namestringoptionalNew name for the label

trello_update_list#Rename, reposition, or archive/unarchive a Trello list. Trello has no permanent list deletion — archiving (closed=true) is the standard way to remove a list from view.4 params▾

Rename, reposition, or archive/unarchive a Trello list. Trello has no permanent list deletion — archiving (closed=true) is the standard way to remove a list from view.

NameTypeRequiredDescription

idstringrequiredThe ID of the list to update

closedbooleanoptionalArchive (true) or unarchive (false) the list

namestringoptionalNew name for the list

posstringoptionalNew position: top, bottom, or a positive number