Beancount.io

Your money in plain text forever — beautiful reports, a phone app, a terminal CLI, and AI agents that can actually do your books.
No lock-in. No database you can't read. Your ledger is a .bean text file you own, diff, and back up with Git — Beancount.io just makes it effortless to use everywhere.

▶ Try the live demo — no sign-up · Sign up and record a transaction · ⭐ Star to support open finance

_{Turn a plain-text ledger into reports you can explore — open the live example.}

No install. No empty-ledger setup. Just record your first real transaction:

1. Sign up at beancount.io/sign-up — already have an account? Log in.
2. Open your ledger (create one if prompted — it takes seconds).
3. Record a transaction — on the web open your ledger's Journal and add an entry; on mobile tap Add Transaction. Try a coffee run: Expenses:Dining 12.50 paid from Assets:Checking.
4. See it land — check the journal, then watch the income statement and balance sheet update.

That's the whole idea: double-entry books you can read as plain text, with reports, phone, terminal, and agents on top of the same ledger.

If Beancount.io is the kind of open, programmable finance you want more of, ⭐ star this repo — it genuinely helps other developers find it.

brew install bex-co/tap/bea      # macOS / Linuxbrew
# or: uv tool install beancount-io   # anywhere with uv + Python 3.12+

bea --no-input init books --currency USD --date 2026-08-01 \
  --opening-balance "Assets:Checking 1000"
cd books
bea add transaction "Coffee" --date 2026-08-02 \
  --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
bea check && bea report balance-sheet

• Sign up, open your ledger, and record the transaction above — on the web or in the mobile app.
• Open the live demo and click through the income statement, balance sheet, and account trees.
• Add two or three real transactions, then check the updated reports.
• Optional: automate with the CLI tutorial or point your coding agent at the skills.

• Plain-text purists — you want double-entry accounting in files that outlive any app, work with Git, and open in any editor.
• Developers — you want to script, query, and build on your finances from Python and the terminal instead of exporting CSVs from a SaaS.
• Agent users — you want Claude Code, Codex, or another coding agent to import statements, reconcile accounts, and close the month, with every write checked and confirm-gated.

Not sure yet? The live demo needs no account — decide there.

Beancount.io stands on Beancount and Fava rather than replacing them — existing ledgers keep working. Full credits: ACKNOWLEDGEMENTS.md.

Review your finances, add transactions, scan receipts, and edit ledger files from the native Beancount client. The same open ledger remains available from the web, terminal, Python, and agent workflows.

_{Explore the mobile product tour or run the Expo app locally.}

Your ledger stays the same plain-text file across all of them — hosted or local-first, with no hosted service required for CLI and skills workflows.

Beancount.io is built for the agent era: your ledger is text an agent can read, and every write is validated and reversible.

• Coding-agent skills (local ledger) — eight beancount-* workflows for Claude Code and Codex: scaffold a ledger, import bank exports without duplicates, reconcile against statements, migrate from Mint/Monarch/QuickBooks, query finances in plain language, and run a confirm-gated month-end close. Install the skills → ask your first question → first-month guide → migration guide.
• MCP server — point any MCP client at a deployment to query and edit a ledger from an agent. Also listed on the official MCP Registry as io.beancount/beancount (OAuth sign-in).

{
  "mcpServers": {
    "beancount": {
      "type": "http",
      "url": "https://your-deployment/api-gateway/mcp",
      "headers": { "Authorization": "Bearer [REDACTED]" }
    }
  }
}

There is no root package to install; each package owns its dependencies and checks.

cd dashboard && corepack enable && yarn install --immutable
cp .env.example .env && yarn dev   # http://localhost:5173

cd mobile && yarn install && yarn start

cd cli && uv sync --all-groups && uv run bea --help

Contributions are welcome across product UI, accounting workflows, accessibility, translations, tests, Python tooling, and agent skills. Start with the contributing guide, browse open issues and the public adoption roadmap, and keep changes focused on one package when possible.

If Beancount.io is the kind of open, programmable finance software you want to see more of, star the repository and help more developers find it.

• Website: beancount.io
• Chat: Telegram
• Mobile: App Store · Google Play
• Issues: github.com/bex-co/beancount-io/issues

Beancount.io stands on Beancount and Fava — the vendored fava package inside cli/src/fava ships as bundled subprocess resources in the single beancount-io distribution, and the rest of the plain-text accounting stack (beanquery, beangulp, rustledger) is used as unmodified upstream dependencies. Full credits and license compliance: ACKNOWLEDGEMENTS.md.

MIT © Beancount.io — covers the code in this repository; upstream projects remain under their own licenses.