Skip to main content
Glama
toof-jp

beancount-mcp-server

by toof-jp
OverviewSchemaRelated ServersScoreDiscussions
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. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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
    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
    A
    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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/toof-jp/beancount-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server