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

NameTypeRequiredDescription
accountIdsarrayNo
fromstringNo
includeTransfersbooleanNo
tostringNo