Skip to main content
Glama
Sign In
beancount-mcp-server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    ActivityInactive
    ResponsivenessLimited data

    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.
      52
      MIT

    • mcp-beancount

      mekanics
      F
      license
      Not graded
      quality
      C
      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