Beancount.io — Claude Code MCP server: query a hosted ledger
Connects your AI agent to a hosted Beancount ledger: BQL queries, reports, files and bank imports.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpWhat Beancount.io does
Beancount.io is an MCP server that gives an agent access to your hosted Beancount ledger. Through it you can run BQL queries, pull reports, work with files and trigger bank statement imports — all from the agent conversation, without switching to the web UI.
The server runs over HTTP and connects with a single command. For Claude that's claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp. Equivalent commands exist for Codex, Cursor, GitHub Copilot and Gemini CLI. Because the transport is HTTP, there's no separate process to start.
You need a personal access token, and those are available on paid plans. Create one in settings and hand it to the agent — without a token the server won't authorize ledger requests. The token is shown once, so keep it in a secret manager.
What it helps with
- run a BQL query against the ledger from the agent chat
- pull a financial report without opening the web UI
- import a bank statement into the ledger
- view and edit ledger files through the agent
- reconcile ledger entries against bank transactions
Example prompts for the agent
- Show all accounts with a non-zero balance this month
- Import the statement from
statement.csvinto the ledger - Reconcile the latest transactions against the bank statement
How to install Beancount.io
Platform CLI: remote server
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpPlatform CLI: remote server
codex mcp add backend-v2 --url https://beancount.io/api-gateway/mcpConfig file
{
"mcpServers": {
"backend-v2": {
"url": "https://beancount.io/api-gateway/mcp"
}
}
}Config file
{
"servers": {
"backend-v2": {
"type": "http",
"url": "https://beancount.io/api-gateway/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http backend-v2 https://beancount.io/api-gateway/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Beancount.io
How do I install Beancount.io in Claude Code?
Run claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp. The server connects over HTTP, so there's no separate process to start.
What does Beancount.io do?
It gives an agent access to a hosted Beancount ledger: BQL queries, reports, files and bank imports.
Do I need a token to use it?
Yes, a personal access token. It's available on paid plans, created in settings, and shown only once.
