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.

Installation

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

💡 Tip: Make sure you have the appropriate package manager installed. Refer to the official documentation for detailed installation instructions.

Compatibility Matrix

Filter:

Cursor

STDIO
stdio:From mcp.so (unverified)

Claude Desktop

STDIO
stdio:From mcp.so (unverified)

MCP Compatible

STDIO
stdio:From mcp.so (unverified)
Verified - Tested by community
Unverified - Not yet tested
⚡ STDIO🌊 SSE🌐 HTTP

Server Information

License:MIT
Classification:active
Source:Data aggregated from public MCP directories

Quick Stats

Transports:
STDIO
Compatible Clients:3
Install Methods:1

Like this server?

Discover more MCP servers or submit your own to directory.