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

Remote serverstreamable-httpPython

What is the 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

The short version

Note: This server is experimental and may undergo significant changes. It is recommended to use it in a development environment and provide feedback for further improvements.

What it needs from you

  • Python 3.10 or later - uv for managing Python projects (recommended)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
run_queryRun a BQL query against the loaded Beancount file.
beanquery//accounts: Get a list of accounts in the loaded Beancount file.

Configuration

  • Python 3.10 or later - uv for managing Python projects (recommended)

Example prompts to try

  • “Use Beanquery MCP to Tools.”
  • “Use Beanquery MCP to run query.”
  • “Use Beanquery MCP to Resources.”

Frequently asked questions

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