mcp server

moneybin

Open-source, local-first, AI-native personal finance platform built on DuckDB

bsaffel/moneybincommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "moneybin": {
      "command": "uvx",
      "args": [
        "moneybin"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 21, 2026

A local data warehouse for personal finance.

Import financial data into an encrypted DuckDB database on your machine. Explore it with SQL, use built-in reports, or connect your AI assistant through MCP.

Try the demo · Documentation · Architecture

Bring bank exports, linked accounts, and spreadsheets together to track spending, find recurring charges, and follow your net worth. The CLI and 50-tool MCP server read the same tables; the SQL behind each report is available to inspect.

MoneyBin is pre-v1 and installs from source. I use it for my own finances. macOS and Linux are supported; Windows is untested.

Try it

Requires Python 3.12+, uv, Git, and GNU Make.

git clone https://github.com/bsaffel/moneybin.git
cd moneybin
make setup
uv run moneybin demo

The demo loads synthetic data into a separate profile. No bank connection or AI account is needed. It makes demo the active profile.

Query the largest spending categories. This example uses synthetic USD data:

$ uv run moneybin sql query "
    SELECT category, COUNT(*) AS txns, SUM(amount) AS total
    FROM core.fct_transactions
    WHERE amount < 0 AND category IS NOT NULL
    GROUP BY 1 ORDER BY total ASC LIMIT 5"
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┳━━━━━━━━━━━━┓
┃ category            ┃ txns ┃      total ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━╇━━━━━━━━━━━━┩
│ Housing & Utilities │  144 │ -62,676.66 │
│ Food & Drink        │  304 │ -14,353.58 │
│ Services            │   36 │  -5,112.00 │
│ Shopping            │   88 │  -4,889.37 │
│ Transportation      │  113 │  -3,609.95 │
└─────────────────────┴──────┴────────────┘

Follow the getting-started guide to import a bank export and run your first reports.

Connect your AI assistant

From the checkout, connect Claude Desktop:

uv run moneybin mcp install --client claude-desktop

Restart the client, then ask: "Which merchants account for most of my spending?" The MCP setup guide covers other supported clients.

MoneyBin sends no telemetry. If you connect a cloud AI assistant, its provider receives the tool results. See what the AI provider sees for details.

Documentation

Getting started — import your own data
Reports — spending, cash flow, net worth, and saved queries
Features — what works today
Database and security — encryption and backups
Where MoneyBin fits — who it is for and alternatives

Contributing

Bug reports and focused pull requests are welcome. See CONTRIBUTING.md or open an issue. Licensed under AGPL-3.0.