Skip to main content
Glama
toof-jp

beancount-mcp-server

by toof-jp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

beancount-mcp-server

MCP (Model Context Protocol) server for Beancount ledgers. Lets MCP clients (Claude Code, Claude Desktop, etc.) query a ledger with BQL and append new entries.

Tools

Tool

Description

run_query

Run an arbitrary BQL query

list_accounts

List accounts with open/close dates and currencies

get_balances

Per-account balances, filterable by prefix and date

search_transactions

Search postings by text, account, and date range

check_ledger

Validate the ledger (bean-check equivalent)

add_transaction

Append a new transaction (validated before writing)

append_entry

Append raw Beancount directive text (validated before writing)

Related MCP server: Beanquery MCP Server

Usage

The ledger path is taken from the first CLI argument, or from $BEANCOUNT_FILE.

uvx beancount-mcp-server /path/to/main.beancount

Claude Code / Claude Desktop config

{
  "mcpServers": {
    "beancount": {
      "command": "uvx",
      "args": ["beancount-mcp-server", "/path/to/main.beancount"]
    }
  }
}

Docker

docker build -t beancount-mcp-server .
docker run -i --rm -v /path/to/ledger:/data beancount-mcp-server

The image expects the main file at /data/main.beancount (override via BEANCOUNT_FILE).

Development

uv sync
uv run beancount-mcp-server /path/to/main.beancount

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • beancount-mcp

    StdioA
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP Server to query from your Beancount ledger, or submit transaction.
    11
    MIT

  • Beanquery MCP Server

    vanto
    A
    license
    Not graded
    quality
    D
    maintenance
    An experimental server implementing the Model Context Protocol to allow AI assistants to query and analyze financial data stored in Beancount ledger files using the Beancount Query Language.
    53
    MIT

  • mcp-beancount

    mekanics
    F
    license
    Not graded
    quality
    B
    maintenance
    A read-only MCP server that gives AI agents structured access to a Beancount personal finance ledger.
    1
    -

  • beanie-mcp

    klinikal
    A
    license
    A
    quality
    C
    maintenance
    An MCP server for querying Beancount ledgers using natural language, enabling financial analysis through Claude with tools for BQL queries and ledger validation.
    2
    3
    MIT