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)

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 installed

-
license - not tested
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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