Beancount MCP (Model Context Protocol) Server

@StdioA

About Beancount MCP (Model Context Protocol) Server

A MCP Server for beancount query and transaction submmit.

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

StdioA

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "github": {
      "command": "uvx",
      "args": [
        "beancount-mcp",
        "/path/to/your/ledger.bean"
      ],
      "env": {}
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.

Comments

More Other MCP servers

Awesome Mcp Servers

A collection of MCP servers.

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

Inbox Zero AI MCP

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

MCP Toolbox for Databases

MCP Toolbox for Databases is an open source MCP server for databases.

Codelf

A search tool helps dev to solve the naming things problem.