Beanquery MCP Server

@vanto

Basic information

About Beanquery MCP Server

Beancount MCP Server is an experimental implementation that utilizes the Model Context Protocol (MCP) to enable AI assistants to query and analyze Beancount ledger files using Beancount Query Language (BQL) and the beanquery tool.

#personal-finance #mcp#beancount#plaintext-accounting#plaintextaccounting#model-context-protocol #mcp-server

Beanquery MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "beanquery-mcp": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "install",
        "server.py",
        "-v",
        "BEANCOUNT_LEDGER=$(pwd)/sample.bean",
        "--with",
        "beancount",
        "--with",
        "beanquery"
      ]
    }
  }
}

Beanquery MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Beanquery MCP?

Beanquery MCP is an experimental Model Context Protocol (MCP) server that interfaces with Beancount ledger files. It uses the Beancount Query Language (BQL) and the beanquery tool to enable querying and analysis of financial data, allowing AI assistants to interact with Beancount ledgers through a standardized protocol.

How to use Beanquery MCP?

Install with Python 3.10+ and uv (recommended). Run in development mode using mcp dev server.py. Install into Claude Desktop with mcp install server.py, optionally setting the BEANCOUNT_LEDGER environment variable. Use the run_query tool to execute BQL queries and the set_ledger_file tool to specify a ledger file. Access resources at beanquery://tables and beanquery://accounts.

Key features of Beanquery MCP?

Run BQL queries against Beancount ledger files
Set ledger file via tool or environment variable
List accessible BQL tables and accounts
Integrates with MCP for AI assistant communication
Works with Claude Desktop after installation

Use cases of Beanquery MCP?

Query financial data from a Beancount ledger using natural language via an AI assistant
Retrieve a list of accounts or tables for analysis
Test and debug Beancount queries interactively with MCP Inspector

Frequently asked questions

What are the prerequisites for Beanquery MCP?

Python 3.10 or later and uv (recommended) for managing the project.

How do I set the Beancount ledger file?

Use the `set_ledger_file` tool or set the `BEANCOUNT_LEDGER` environment variable when installing.

What tools does Beanquery MCP provide?

It provides `run_query` to run BQL queries and `set_ledger_file` to specify the ledger file.

Is Beanquery MCP stable?

No, the server is experimental and may undergo significant changes. Use in a development environment.

Does Beanquery MCP send my financial data to third parties?

Yes, parts of your ledger may be transmitted to LLM providers via MCP. The README includes a privacy warning and recommends caution, especially with sensitive data.

Comments

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K