MCP.so
Sign In

Beancount MCP (MCP) Server

@StdioA

Basic information

Category

Other

License

MIT

Transports

stdio

Author

StdioA

About Beancount MCP (MCP) Server

A MCP Server for beancount query and transaction submmit.

Beancount MCP (MCP) Server 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": {}
    }
  }
}

Beancount MCP (MCP) Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Frequently asked questions

1

What does Beancount MCP do?

It lets an MCP host (like Claude Desktop) run Beancount queries and add transactions to your ledger.

2

How do I install Beancount MCP?

Install it via the `uvx` tool. No separate install step is mentioned; run `uvx beancount-mcp` directly.

3

What transport options are available?

You can use `--transport=stdio` (default) or `--transport=sse` for HTTP streaming.

4

What runtime dependencies are required?

You need `uvx` and a Beancount ledger file. No additional dependencies are listed.

5

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