Beancount MCP Server is an experimental implementation that utilizes the Model Context Protocol (MCP) to enable AI assistants to query and analyze
Most developer tooling work still happens through a UI a human drives. Beanquery MCP MCP server moves it into the conversation instead. 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.
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.
The server publishes 5 tools. What each one is for:
Tools — - set_ledger_file: Set the Beancount ledger file to use for queries (if not set via environment variable)run_query — Run a BQL query against the loaded Beancount fileResources — - beanquery://tables: Get a list of tables that BQL can accessbeanquery — //accounts: Get a list of accounts in the loaded Beancount filePrerequisites — The Prerequisites tool exposed by this serverBecause this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Beanquery MCP's toolset — Tools, run_query, Resources and 2 more — is a fair guide to whether it matches your workflow. It is maintained by vanto; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Beanquery MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Tools | - set_ledger_file: Set the Beancount ledger file to use for queries (if not set via environment variable). |
| run_query | Run a BQL query against the loaded Beancount file. |
| Resources | - beanquery://tables: Get a list of tables that BQL can access. |
| beanquery | //accounts: Get a list of accounts in the loaded Beancount file. |
| Prerequisites | The Prerequisites tool exposed by this server. |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.