House of Hearth links your bank, credit and brokerage accounts through Plaid, keeps everything in a single encrypted SQLite file, and ships a read-only MCP server so you can simply ask Claude about your finances. Nothing is hosted. Nothing leaves your laptop.
Spreadsheets make you hunt. House of Hearth's local MCP server hands Claude five read-only query tools — so you ask a question in your own words and get an answer straight from your own data.
The agent can read your spending. It can never move money, call Plaid, or decrypt your bank tokens.
Every design choice favours your privacy and your control.
A local stdio MCP server exposes five read-only tools so Claude answers questions from your real numbers.
Plaid tokens are sealed with AES-GCM; the master key lives in your OS keychain, never on disk. A stolen DB file is inert.
Plaid's cursor sync commits one page at a time and soft-deletes removed rows — a sync that dies mid-run resumes cleanly.
A pure-Python core/ layer is shared by the FastAPI app and the MCP server, so query logic lives in exactly one place.
The MCP server opens SQLite read-only, never imports the crypto layer, and has no path to Plaid. Worst case: it reads.
No cloud, no public ingress, no webhooks. It runs only when you open it — on your hardware, under your login.
Clone it, add your Plaid Sandbox keys, and you're running locally in minutes.
# 1 — clone $ git clone https://github.com/Kandel-Bibas/House_of_Hearth.git $ cd House_of_Hearth # 2 — backend (Python 3.11+) $ python3 -m venv .venv && source .venv/bin/activate $ pip install -e ".[dev]" && cp .env.example .env # add Plaid keys # 3 — frontend $ cd frontend && pnpm install && cd .. # 4 — run the API + UI together $ make dev → API http://localhost:8000 → UI http://localhost:5173
Full setup, the HTTP/MCP reference, and the security model are in the README. Wiring it into Claude Desktop takes one config block — see the MCP setup guide.
The secrets layer uses the cross-platform keyring library, so your master key sits in the native vault on every OS.
make dev / uvicorn + vite