Skip to main content

Ask your budget anything.

Connect Claude to your Actual Budget. Ask where the money went, get real analysis back, and let it write without holding your breath.

> Based on my spending so far, will I end up over or under budget this month?

Category      Budget    Spent    Projected   Status
────────────  ────────  ───────  ─────────   ──────
Groceries     $600      $412     $578        ✓ On track
Dining Out    $200      $187     $262        ✗ Over by $62
Transport     $150      $89      $125        ✓ Under
Shopping      $300      $245     $343        ✗ Over by $43
─────────────────────────────────────────────────────
Overall       $1,250    $933     $1,308      ⚠ $58 over

> Move $60 from Transport to Dining Out

✓ Done. Transport: $150 → $90. Dining Out: $200 → $260. Your projected overage drops from $58 to $2.

> What day of the week do I spend the most?

Saturdays, averaging $127/week vs $45 on weekdays. Most of it is Dining Out and Shopping. Last 3 months show the same pattern.
Runs locally. Your financial data never leaves your machine.

Listed in the official Actual Budget community projects.

On Claude Desktop there is nothing to paste: install the extension.

How it works.

01

Install the extension, or one command

Drag one file into Claude Desktop, or paste a single line for Claude Code, Cursor or Docker. No cloud accounts, no API keys to manage.

02

Point it at your Actual Budget

Set your server URL and password. Your data stays on your machine. Nothing is sent anywhere.

03

Ask Claude anything about your finances

Query accounts, analyze trends, create transactions, reallocate budgets, without leaving the conversation.

Just ask.

Will my budget last this month?
Spent $50 at Walmart today
Which category is killing me?
Move $200 from Checking to Savings
Spending trends for the last 6 months
Budget vs actual this month

Because "am I overspending on food?" shouldn't require three filters and a custom date range to answer.

Read, analyze, and edit.

37 tools across 3 categories. Everything you need without leaving the conversation.

Read9

accounts · budget · transactions · categories · payees · rules · balances · history · summary

Analyze5

budget vs actual · projections · category trends · spending breakdown · month summary

Write & maintain23

create · split · update · delete · transfer · recategorize · budget amounts · categories · payees · rules · bank sync · currency reconciliation · sync repair

What makes it different

Deletes stop and ask - every destructive tool shows what it will remove and waits for you to confirm
Read-only mode - set ACTUAL_READ_ONLY=1 and the write tools disappear from the model entirely
Analysis, not just lookups - projections, category trends, budget vs actual
Multi-currency that survives reality - split transactions and residual reconciliation
Say names, not IDs - "Checking" or "Groceries", not UUIDs
Natural dates in English and Spanish - "last month", "este mes", "hace 3 meses"
Built on @actual-app/api 26.8, and tested against the version you install

See it work.

A real session against a demo budget. Note the second half: the delete stops and asks, because the transaction was already cleared.

Terminal session: asking where the money went in July returns a spending table with over-budget categories, then asking to delete a Netflix charge stops to ask for confirmation

Get started.

✓ Actual Budget running with the server enabled

✓ Claude Desktop, Claude Code, or any MCP client

Claude Desktop

Install the extension

One file, nothing to compile and no config to edit. Open Claude Desktop, go to Settings, then Extensions, and drag the file there. Fill in your server URL, Sync ID and password, and ask.

Download the extension

56 MB, everything included. Needs Node.js 22 or newer. On Windows, drag it into Settings, Extensions: double-clicking the file does not open Claude.

Other clients, from the command line:

Your budget ID is the Sync ID in Actual under Settings → Show advanced settings.

Step by step, with screenshots of what to fill in: How to connect Actual Budget to Claude.

GitHub npm