Financial Recap
Generate a narrative financial review for any time period.
Workflow
- Determine the period. Parse
$ARGUMENTS for the time span:
- "this week", "last week" → weekly
- "this month", "january", "jan 2025", "2025-01" → monthly (default if no argument)
- "this quarter", "Q1", "Q1 2025" → quarterly
- "this year", "2025", "year in review" → yearly
- Any explicit date range works too
- Fetch summary data. Call the
query MCP tool with compare: "prior_period":
```json
{ "period": "period>", "compare": "priorperiod", "include": ["ratios", "anomalies", "accounts"] }
```
(Use start/end if a specific date range was requested.)
- Fetch year-ago comparison. For anything other than year-over-year, also fetch the same period from a year ago to account for seasonality:
```json
{ "start": "periodlastyearstart>", "end": "periodlastyearend>", "include": ["ratios"] }
```
For example, if reviewing February 2026, also fetch February 2025.
- Fetch recurring bills. Call the
query MCP tool:
```json
{ "recurring": true }
```
- Synthesize a narrative recap covering:
- Headline numbers: total income, total expenses, net cash flow, savings rate
- vs. prior period: changes from the immediately preceding period (last week, last month, etc.)
- vs. same period last year: seasonal context — note whether changes are normal for this time of year or unusual (skip this section for year-over-year recaps)
- Anomalies: unusual transactions or spending spikes
- Recurring bills: new, changed, or cancelled subscriptions/bills
- Key ratios: any ratios returned in the summary (e.g. expense-to-income)
- Account balances: current balances and changes
- Tone: Stick to the facts. Report what happened without judgement — no "great job" or "you need to cut back." Just clear, plain-language observations. Skip categories with trivial amounts.