get_spending_analytics
Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.
Description
Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.
Returns a `report` field with emoji labels (e.g. "🍽️ Food & Drink: $459.00 USD") — present `report` verbatim to the user; do not strip emojis or reformat amounts.
Also returns `charts` (labels + values) for category spend — when present, ALWAYS render a chat-visible bar chart/image; do not reply with numbers only or write source files.
Use this for: "How much did I spend on food this month?", "What's my total income this year?", "Which vendors cost me the most?", "chart my spending".
Income vs expense follows transaction type (same as list_transactions), not amount sign.
from/to are RFC 3339 date strings. Either bound is optional. accountIds is optional — omit to include all accounts; call list_accounts to get IDs for filtering. Transfers are excluded by default; set includeTransfers=true to include them.Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
accountIds | array | No | |
from | string | No | |
includeTransfers | boolean | No | |
to | string | No |