LABSCO 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_PATH_TO_LEDGER>. 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 <YOUR_PATH_TO_LEDGER>
USE CASES
01
Answering a question about your own books
Ask in words and let the server turn it into a Beancount query against your ledger.
02
Recording an expense as you think of it
Submit the transaction instead of leaving a note to add it later.
BEFORE YOU INSTALL
What to know first
Requires
uvx on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx beancount-mcp --transport=stdio <YOUR_PATH_TO_LEDGER>MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"https://github.com/StdioA/beancount-mcp/tree/master": {
"command": "uvx",
"args": [
"beancount-mcp",
"--transport=stdio",
"<YOUR_PATH_TO_LEDGER>"
],
"disabled": false,
"autoApprove": []
}
}
}
