Beancount MCP (Model Context Protocol) Server
@StdioA
A MCP Server for beancount query and transaction submmit.
Overview
What is Beancount MCP?
Beancount MCP is a Model Context Protocol server that enables AI assistants to execute queries and submit transactions to a Beancount ledger.
How to use Beancount MCP?
Run uvx beancount-mcp [--transport=stdio/sse] your_ledger.bean to start the server. For Claude Desktop, add an entry to claude_desktop_config.json specifying the command and path to your ledger.
Key features of Beancount MCP
- Execute Beancount queries on the ledger
- Submit new transactions to the ledger
- Supports both stdio and SSE transport modes
- Integrates with Claude Desktop out of the box
Use cases of Beancount MCP
- Query a Beancount ledger via natural language through an AI assistant
- Record a new transaction by describing it in plain English
- Automate accounting tasks by combining queries and submissions
FAQ from Beancount MCP
What does Beancount MCP do?
It lets an MCP host (like Claude Desktop) run Beancount queries and add transactions to your ledger.
How do I install Beancount MCP?
Install it via the uvx tool. No separate install step is mentioned; run uvx beancount-mcp directly.
What transport options are available?
You can use --transport=stdio (default) or --transport=sse for HTTP streaming.
What runtime dependencies are required?
You need uvx and a Beancount ledger file. No additional dependencies are listed.
Where does the ledger data live?
The server reads from the ledger file you specify on the command line. Data is not stored by the server itself.
