Introduction
krabs.dev is a personal finance tracker designed to be operated by AI agents. Income, expenses, cashflow — products, subscriptions, invoices, expenses — reachable as tools instead of pages. Self-hosted, open source, no login.
What is krabs
Existing finance tools assume the operator is a human clicking through forms. krabs assumes the operator is a model. Every record is reachable over three interfaces with the exact same object graph behind them. Every mutation is idempotent, dry-runnable, and reversible.
One founder, plus a fleet of agents, can operate at the scale of a 20-person team — so long as the substrate they share is one designed for them.
Three doors
The same operation can be invoked over three transports. Pick the one your agent already speaks.
| transport | endpoint | for |
|---|---|---|
MCP | mcp.krabs.dev | agentic hosts — Claude Desktop, Cursor, Claude Code |
CLI | krabs | shell-driven agents, humans, scripts |
HTTP | api.krabs.dev | everything else — n8n, cron, your own UI |
Primitives
Four finance primitives plus finance reporting. The full set of operations is described at /v1/schema.
product— something you sell, with a name and price.subscription— recurring revenue, optionally tied to a counterparty.invoice— a one-off charge, with status (draft, sent, paid, void).expense— money out, with an amount and category.finance— reporting: summary, MRR, expenses by category, funnel.
Next steps
- Quickstart → get a key, wire krabs into Claude Desktop, run your first command in five minutes.
- Auth & tokens → how to mint, scope, and rotate keys.
- The contract → what the operation spec guarantees.