ynab_list_transactions
Search and filter YNAB transactions by date, account, category, payee, amount, text, or status, returning compact rows with inflow/outflow totals and split details.
Instructions
Search transactions (newest first) with filters for dates, account, category, payee, amount and text. Returns a page of compact rows plus inflow/outflow totals for all matches. Split transactions show their splits; when filtering by category or payee, matching split lines are returned individually.
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": "ynab_list_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Case-insensitive text to find in payee, memo or category. | |
| limit | No | Max rows to return. | |
| month | No | Restrict to one month ('current', 'YYYY-MM'); sets the dates. | |
| offset | No | Rows to skip (use next_offset from a prior call). | |
| status | No | Only uncategorized or only unapproved transactions. | |
| cleared | No | Filter by cleared status. | |
| plan_id | No | Plan (budget) id from ynab_list_plans. Omit to use the configured default plan. | |
| payee_id | No | Only this payee (id from ynab_list_payees). | |
| direction | No | Only money in (inflow) or money out (outflow). | |
| account_id | No | Only this account (id from ynab_list_accounts). | |
| max_amount | No | Maximum absolute amount in currency units. | |
| min_amount | No | Minimum absolute amount in currency units, e.g. 100 = $100. | |
| since_date | No | Earliest date (YYYY-MM-DD). Defaults to 30 days ago unless month is given. | |
| until_date | No | Latest date (YYYY-MM-DD). | |
| category_id | No | Only this category (id from ynab_list_categories). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||