Beancount MCP (Model Context Protocol) Server

@StdioA

About Beancount MCP (Model Context Protocol) Server

A MCP Server for beancount query and transaction submmit.

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

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

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.

Frequently asked questions

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

Basic information

More Other MCP servers

Codelf

unbug

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

14.2K

Inbox Zero AI MCP

elie222

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

11.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

MCP Registry

modelcontextprotocol

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

7.0K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K