MCP-based personal finance AI Agent powered by Beancount
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"quidclaw-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# QuidClaw MCP Your AI-powered Personal CFO. *Local-first. Privacy by design. Your data never leaves your machine.* QuidClaw MCP is an open-source [MCP](https://modelcontextprotocol.io/) server that gives AI assistants the ability to manage your personal finances using [Beancount](https://beancount.github.io/) double-entry accounting. Connect it to Claude, ChatGPT, or any MCP-compatible client — and you have a Personal CFO that tracks every dollar, generates reports, and keeps your books clean. > **"Lunch was $12, paid with Apple Pay"** → AI calls QuidClaw MCP → proper double-entry transaction recorded in your local ledger. [Chinese / 中文文档](README.zh-CN.md) ## Why QuidClaw MCP - **Privacy first** — All data stored locally as plain text. No servers, no cloud, no telemetry. Nothing ever leaves your machine. - **You own your data** — Standard Beancount `.bean` files you can read, edit, and version control. No vendor lock-in, no proprietary formats. - **AI-powered, not AI-dependent** — QuidClaw MCP is just tools. The intelligence comes from your AI client. Switch AI providers anytime. ## How It Works ``` You ──(natural language)──→ AI Client ──(MCP)──→ QuidClaw MCP ──→ Beancount ↓ ~/.quidclaw/*.bean ``` - **You** talk naturally to your AI assistant - **AI** understands your intent and decides which tools to call - **QuidClaw MCP** provides 10 MCP tools that read/write Beancount ledger files - **Data** is stored locally as plain text — you own it completely QuidClaw MCP doesn't run any AI model. It's a bridge between your AI client and the Beancount accounting engine. ## Features - Record transactions via natural language - Multi-currency support (USD, EUR, CNY, etc.) - Balance queries and reconciliation - Financial reports (income statement, balance sheet) - Flexible BQL (Beancount Query Language) queries - Price tracking for stocks, …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.