Ledgerly v0.1.0 — your money, your account, your AI
The first public release of Ledgerly — a private, self-hosted personal-finance
dashboard that runs entirely in your own Cloudflare account: transactions
in your D1 database, receipts and statements in your R2 bucket, served by a
Worker you control. No vendor in the middle, nothing phones home. AGPL-3.0.
Highlights
The mail-in feed — bank sync with no bank connection. Your bank already
emails you transaction alerts, receipts, and statements. Route them to an
address you control and they become proposed transactions in seconds — no
bank credentials, no aggregator, works with any bank that can send an email.
Allow-listed senders only, everything is suggestion-only, and inbound email
never triggers AI. Bank formats are community-contributed parser packs.
Setup: docs/EMAIL-FEED.md.
Chat with your money (MCP). Ledgerly is a read-only MCP server — add
your instance to Claude Code, Claude Desktop, or any MCP client and ask
"what did I spend on dining last month?" Six deterministic tools behind a
bearer token; no mutating tool exists. Setup: docs/MCP.md.
AI that only ever suggests. Receipt extraction (one photo → one proposed
transaction with per-field confidence) and PDF statement extraction (one
statement → a reviewable batch with duplicate pre-flagging) via Workers AI
in your own account or bring-your-own-key Anthropic. Every field is
re-validated server-side; nothing enters your ledger without your click.
A deterministic core that learns. Repeated category corrections become
suggested rules you approve. The recurring-detection engine powers 30/60/90-
day cash-flow forecasts (income and expenses, calendar-exact). Weekly or
daily WhatsApp briefings via your own Meta Cloud API credentials.
Honest by construction. Empty states are empty — no sample data, ever.
Ambiguous imports ask. Uncertain extractions go to review. 883 tests.
Getting started
Local in two commands: npm install && npm run dev — no Cloudflare account
needed. Deploy to your own account in ~10 minutes: see the
README.