Breadbox is an open-source, self-hosted financial aggregator for households. It manages connections to your banks via Plaid or Teller, syncs your transactions into a structured database you control, and hands that data to the AI apps you already use through a built-in server. Breadbox is not an agent. It’s the infrastructure that makes the agents you already trust — Claude, ChatGPT, Manus, Openclaw — dramatically more useful for personal finance. You host it, you own the data, you pick the agents.Documentation Index
Fetch the complete documentation index at: https://docs.breadbox.sh/llms.txt
Use this file to discover all available pages before exploring further.
Why Breadbox?
Your agents already know you
Off-the-shelf categorization engines look at a merchant name and guess. The Claude or ChatGPT you use every day has context no automated categorizer will ever have — it knows your recurring subscriptions, your family’s routines, the business you run, and — if you connect a Gmail or email MCP alongside Breadbox — can cross-reference the actual receipts sitting in your inbox to confirm what a charge really was. Give it that kind of access and it categorizes, classifies, and analyzes your finances with an accuracy a rules-only system can’t match.The system gets smarter over time
Every time an agent decides “PG&E charges are Utilities, here’s the rule,” it can persist that decision as a Breadbox rule. Breadbox auto-applies that rule on every subsequent sync — so each review pass starts from an ever-more-accurate baseline. Your rule library becomes a custom, continuously-improving model of your financial life — maintained by the agents you already use, running against data you control.It’s free and open source
Breadbox is free to run and open source on GitHub under the AGPL-3 license. No SaaS middleman, no per-account pricing, no monthly bill. You host it, you own your data, and you can audit or extend the code whenever you need to.Key benefits
AI-ready via MCP
A built-in server lets AI agents like Claude, ChatGPT, Manus, and Openclaw query and reason over your financial data — using the context they already have about you — without ever touching your bank credentials.
Self-improving rules
Agents don’t just categorize transactions — they can create and maintain rules tailored to your spending patterns. Over time your rule library handles more of the work automatically, letting agents focus on what’s genuinely new.
Your data, your database
All transactions live in a PostgreSQL database you own. No vendor lock-in — back up, export, audit, or delete at any time.
Open source & self-hosted
Single Go binary, open source on GitHub. Run it on your own hardware, in a VPS, or anywhere Docker runs — no SaaS middleman between your agents and your bank data.
Features
Data sync
- Bank sync via Plaid, Teller, and CSV import (with more coming)
- Account linking to deduplicate transactions across connections (e.g., dependent cards)
Categorize and tag
- Self-improving rules engine — agents create and maintain rules with recursive AND/OR/NOT conditions; your pattern library grows smarter over time
- Category system with a two-level hierarchy
- Tag-based workflows — tags allow flexible coordination between humans and agents (e.g., the seeded tag marks every new transaction so an agent can work through them and clear the tag as it goes)
Agents and integrations
- MCP server for AI-agent integration — Streamable HTTP at
/mcpand stdio - REST API with cursor pagination, field selection, and filtering
- Agent reports for AI agents to submit summaries and flag transactions
- Admin dashboard for connection management, sync monitoring, and transaction review
Self-hosting
- API key auth with scoped access (full-access or read-only)
- AES-256-GCM encryption for all provider credentials stored at rest
- Single binary — one Go binary serves everything: API, MCP server, admin dashboard, webhooks, and the sync scheduler
What you need to get started
Before installing Breadbox, make sure you have the following:| Requirement | Details |
|---|---|
| A machine | Any Linux or macOS host — a VPS, a spare laptop, a NAS with Docker, or your workstation for a local eval. |
| Docker | Docker Engine + Docker Compose. The one-liner installer offers to bootstrap Docker on Linux if it’s missing. |
| PostgreSQL | Version 16 or later. Handled automatically by Docker Compose. |
| Bank API credentials | Plaid Client ID + Secret, or a Teller App ID — or both. |
Next steps
Install Breadbox
Set up Breadbox with Docker, a pre-built binary, or from source.
Get started
Go from zero to your first synced transaction in minutes.