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:

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

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