MCP.so
Sign In

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