Beanquery MCP

Name: Beanquery MCP
Availability: InStock
Author: vanto

Supports UI

by vanto

Connect AI assistants to Beancount ledger files using Beancount Query Language (BQL) for financial analysis.

0 stars

0 views

Works in:claude

Exposes:ToolsResources

View on GitHub

What it does

Connects AI assistants to Beancount plaintext accounting ledger files, allowing them to query and analyze financial data using the Beancount Query Language (BQL) and the beanquery tool.

Tools

set_ledger_file: Specifies the Beancount ledger file to be used for queries.
run_query: Executes a BQL query against the loaded Beancount ledger.

Installation

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "beanquery": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "install",
        "server.py",
        "-v",
        "BEANCOUNT_LEDGER=/path/to/your/ledger.bean",
        "--with",
        "beancount",
        "--with",
        "beanquery"
      ]
    }
  }
}

Supported hosts

Claude Desktop

Quick install

uv run mcp install server.py -v BEANCOUNT_LEDGER=/path/to/your/ledger.bean --with beancount --with beanquery

Information

Pricing: free
Published: 5/16/2026
stars