search_transactions
Search and filter transactions. Returns transaction amount (original + base currency), category, account, payee (payeeId and payee { id, name }), note, date, type, and tags. Filter by payee with payeeIds (get_payees resolves a name to an id) and by planned state with isPlanned. Use date filters to limit results. Default: last 30 days, 50 items; future plans need a later endDate.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default: 50, max: 500) | |
| order | No | Sort order by date (default: desc) | |
| offset | No | Pagination offset (default: 0) | |
| search | No | Search in transaction notes | |
| tagIds | No | Filter by tag IDs | |
| endDate | No | End date (ISO 8601). Default: now, which hides planned (future-dated) transactions. Set it to a future date to see upcoming plans | |
| payeeIds | No | Filter by payee (merchant) IDs. Use get_payees to resolve a merchant name to its id | |
| amountMax | No | Maximum amount (decimal, in original currency) | |
| amountMin | No | Minimum amount (decimal, in original currency) | |
| isPlanned | No | true: only your planned transactions (upcoming, not yet confirmed); false: only real ones. Omit for real ones plus your plans. Plans are dated in the future, so also set endDate beyond them | |
| startDate | No | Start date (ISO 8601). Default: 30 days ago | |
| accountIds | No | Filter by account IDs | |
| categoryIds | No | Filter by category IDs | |
| excludeRefunds | No | Exclude refund transactions | |
| transactionType | No | Filter by transaction type | |
| excludeTransfers | No | Exclude transfer transactions |