---
ref: tool:trello/search
name: Search Trello
company: company:trello
workflows: []
access: [api]
tags: [capability:manage-tasks, category:project-management, has:api]
docs: https://developer.atlassian.com/cloud/trello/rest/api-group-search/#api-search-get
updated: 2026-09-27
---

# Search Trello

Finds the boards, cards, members and organizations that match a query.

`query` is required; narrow it with `idBoards`, `idOrganizations` or `modelTypes`, and cap results with `cards_limit` and `boards_limit`.

## Set up

Use the first option your agent supports.

### API (official)

- Base URL: https://api.trello.com/1
- Endpoint: `GET /search`
- Auth: OAuth; sign in when the agent asks
- Docs: https://developer.atlassian.com/cloud/trello/rest/

Before doing anything else, make one read-only call to confirm access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.