Your AI Agent, Your Local Budget
Hand a PDF statement to Claude Code or Codex and let it do the typing. FireBudget shows you what will change before anything is written, and the budget stays on your Mac.
You: Import ~/Downloads/visa-sep-2026.pdf into Visa. Card payments came from Checking. Show me a preview first.
firebudget · list_accounts, list_payees, list_scheduled
firebudget · import_transactions (dry run)
Agent: Preview for Visa, 43 rows. Nothing has been written yet:
- Opening balance matches the last reconciled balance
- 40 new transactions, categorized from your payee history
- 2 already in FireBudget, will be skipped
- 1 card payment, linked to the Checking transfer on Sep 3
- ⚠ Possible duplicate: Trader Joe’s −$18.40 on Sep 12. Keep both or skip?
You: Skip it, then reconcile. The statement says I owe $624.37.
firebudget · import_transactions · reconcile (preview, then commit)
Agent: Imported 39 transactions, marked cleared. Cleared balance matches −$624.37, so Visa is reconciled through Sep 30.
What it does
The Tedious Parts, Delegated
Import statements
Point your agent at a PDF bank or card statement. It maps each row to your accounts, payees, and categories, shows you a dry run, and imports when you agree.
Reconcile accounts
Give it the statement's closing balance. The agent clears the matching transactions and reconciles only when the cleared balance and the statement agree.
Budget the month
Ask it to assign money or move it between categories. You see each category’s available amount and Available to Budget before and after, and nothing is saved until you agree.
Tidy transactions
Clean up memos, fix payees and categories, correct a date or amount, or merge payees such as MY TNB-EC and MYTNB SSP-EC into one, with a preview of every change before it is saved.
Search and summarize spending
Find every transaction from one merchant across all your accounts, or see spending per category for each month of the year, totalled the same way as the budget’s Activity column.
Answer questions
Ask about balances, what is left to budget, upcoming recurring payments, or what is still uncategorized. The agent looks it up in your budget instead of guessing.
Safeguards
Nothing Changes Without a Preview
The agent works through FireBudget's own checks, not around them. The same rules that keep your balances correct in the app apply to everything it does.
- Every import can run as a preview (a dry run) that writes nothing and returns exactly what a real run would.
- Re-importing the same statement creates nothing. Rows already in FireBudget are matched.
- Possible duplicates are flagged, and the import is refused until the agent explicitly accepts them. Agents are instructed to ask you first.
- A credit card payment links to the existing checking transfer instead of being entered twice.
- Before an import, the agent checks the statement’s opening balance against the last reconciled balance, so a skipped statement shows up straight away.
- Recurring payments and loan interest are listed for the statement period, so recurring rows are matched and interest FireBudget already posted is not entered twice.
- Every import is all-or-nothing. One bad row means nothing is written.
- A wrong import can be undone on its own, without restoring a backup, as long as its rows have not been changed since.
- FireBudget takes a safety snapshot before each import, edit, payee rename, and undo, listed under Settings → Backups.
- Reconciled transactions stay locked unless you explicitly allow an edit.
Good to know
- Your agent reads the PDF, not FireBudget, so check the preview. Reconciling to the statement's closing balance catches any misread amount.
- Agents can undo one of their own imports, but cannot delete other transactions, move them between accounts, or convert them to transfers. Do those in FireBudget.
- FireBudget has to be open. The agent connection stops when the app quits.
- Claude Desktop chat, Cowork, and ChatGPT on the web are not supported yet.
- The token keeps out other users and devices, not software already running under your own Mac account. Turn access off when you are not using it.
Privacy
You Decide What the Agent Sees
Off by default
Nothing listens until you turn on agent access in Settings, and you can turn it off at any time.
Only on your Mac
The connection is served from 127.0.0.1, so other devices on your network cannot reach it.
Token protected
Each agent needs the access token from Settings. Rotate it and old connections stop working immediately.
Your provider sees what you share
FireBudget sends nothing to an AI service itself. Your agent does read the statements and budget rows it works with, so its AI provider sees that data.
Supported agents
Bring the Agent You Already Use
- Claude Code
- The CLI and the Code tab in the Claude desktop app. One terminal command to add.
- Codex
- The Codex CLI, the ChatGPT desktop app, and the IDE extension. One entry in config.toml.
- Other MCP clients
- Anything that supports Streamable HTTP with a custom Authorization header.
Setup
Three Steps to Connect
- 1 Open Settings in FireBudget, find Agent access (MCP), and turn on Allow local AI agents to access this budget.
- 2 Pick the Claude Code, Codex, or Other tab and copy the ready-made snippet. It already includes your token.
- 3 Paste it into your agent, then ask in plain language.
Try asking
Plain Language Is Enough
- Import ~/Downloads/checking-sep-2026.pdf into Checking. Show me a preview first.
- Import this credit card statement into Visa. Card payments came from Checking.
- Use the categories I used last time for the same merchants. Ask me before creating any new ones.
- The Visa statement says I owe 624.37. Reconcile Visa.
- Reconcile failed with a difference. Find which transactions explain it, but don't change anything until I confirm.
- Which payees did I spend the most on last month, and in which categories?
- Budget November the same as October, but put 300 more into Car Maintenance.
- How much did I spend on Work Subscriptions each month this year?
- That Visa import was the wrong statement. Undo it.
- MY TNB-EC and MYTNB SSP-EC are the same payee. Merge them.
Agent Access Questions
What to know before you connect an agent
What is MCP?
Do I need an AI subscription?
Does FireBudget connect to my bank through the agent?
Can the agent make a mess of my budget?
Is agent access included in the purchase?
Included With FireBudget
Agent access is part of the $39 one-time purchase, alongside multi-month budgeting, recurring transactions, loan interest, and reports. Includes 2 years of free software upgrades.