recap

Financial Recap

Generate a narrative financial review for any time period.

Workflow

1. Determine the period. Parse $ARGUMENTS for the time span:
2. "this week", "last week" → weekly
3. "this month", "january", "jan 2025", "2025-01" → monthly (default if no argument)
4. "this quarter", "Q1", "Q1 2025" → quarterly
5. "this year", "2025", "year in review" → yearly
6. Any explicit date range works too

1. Fetch summary data. Call the query MCP tool with compare: "prior_period":

``json { "period": "<detected_period>", "compare": "prior_period", "include": ["ratios", "anomalies", "accounts"] } ` (Use start/end` if a specific date range was requested.)

1. 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": "<same_period_last_year_start>", "end": "<same_period_last_year_end>", "include": ["ratios"] } `` For example, if reviewing February 2026, also fetch February 2025.

1. Fetch recurring bills. Call the query MCP tool:

``json { "recurring": true } ``

1. Synthesize a narrative recap covering:
2. Headline numbers: total income, total expenses, net cash flow, savings rate
3. vs. prior period: changes from the immediately preceding period (last week, last month, etc.)
4. 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)
5. Anomalies: unusual transactions or spending spikes
6. Recurring bills: new, changed, or cancelled subscriptions/bills
7. Key ratios: any ratios returned in the summary (e.g. expense-to-income)
8. Account balances: current balances and changes

1. 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.