Trello ACTION
Search Boards
Searches for boards matching the specified query. See the documentation.
- Action
- Read only
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Trello account once, then configure and run Search Boards from your backend or agent.
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-search-boards",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
trello: { authProvisionId: "apn_xxxxxxx" },
query: "Query",
idOrganizations: ["Organization IDs"],
},
})
console.log(result)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-search-boards",
"configured_props": {
"trello": { "authProvisionId": "apn_xxxxxxx" },
"query": "Query",
"idOrganizations": ["Organization IDs"]
}
}'// 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()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "trello-search-boards",
arguments: {
query: "Query",
idOrganizations: ["Organization IDs"],
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
query Query | string | The search query with a length of 1 to 16384 characters Required |
idOrganizations Organization IDs | string[] | Specify the organizations to search for boards in Optional Dynamic |
partial Partial Search? | boolean | Specifying partial to be true means that Trello will search for content that starts with any of the words in query. When searching for an object titled "My Development Status Report", by default a solution is to search for "Development". If partial is enabled, a search for "dev" is possible, however, a search for "velopment" is not possible. Optional |
boardFields Boards Fields | string[] | all or a list of board fields to be returned in the results Optional |
boardsLimit Boards Limit | integer | The maximum number of boards to return. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- trello-search-boards
- Version
- 0.3.7
- App
- Trello
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗