Summary
It reads and writes the same plain-text ledger you already keep.
The ledger is a file path on the command line, so the whole surface is that one file — query it in conversation, and append to it when you would otherwise open an editor. Nothing is uploaded and there is no account in the loop.
What it is
A small MCP server for Beancount. It takes the path to your ledger file and can both run queries against it and submit new transactions.
What you get
- Run a Beancount query against your ledger and get the result back
- Submit a transaction to the ledger from the conversation
- Stdio or sse transport, chosen with --transport
Requirements
The path to your .bean ledger, passed as an argument: uvx beancount-mcp --transport=stdio your_ledger.bean. The published package is beancount-mcp, version 0.1.1; there is no service to sign into.
Setup effort
One command — uvx beancount-mcp --transport=stdio PATH_TO_YOUR_LEDGER