Trello ACTION
Search Cards
Searches for cards 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 Cards 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-cards",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
trello: { authProvisionId: "apn_xxxxxxx" },
query: "Query",
idBoards: ["Boards"],
},
})
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-cards",
"configured_props": {
"trello": { "authProvisionId": "apn_xxxxxxx" },
"query": "Query",
"idBoards": ["Boards"]
}
}'// 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-cards",
arguments: {
query: "Query",
idBoards: ["Boards"],
},
})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 |
idBoards Boards | string[] | The IDs of boards to search for cards 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 |
cardFields Cards Fields | string[] | all or a list of card fields to be returned in the results Optional |
cardsLimit Cards Limit | integer | The maximum number of cards 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-cards
- Version
- 0.2.7
- App
- Trello
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗