# Beanquery (Beancount Ledger)

> Use this tool when you need to analyze and query financial ledger data for personal finance tracking, expense analysis, or generating financial reports. It solves problems related to accessing and understanding Beancount ledger files by providing a query interface that returns tabular results. The tool takes Beancount Query Language (BQL) inputs and outputs tabular data, making it ideal for use cases where financial data insights are required without direct command-line tool access.

Canonical page: https://skillsregistry.net/skills/vanto-beanquery  
JSON: https://api.skillsregistry.net/v1/skills/vanto-beanquery

## Description

Beancount MCP Server enables AI assistants to query and analyze Beancount ledger files using Beancount Query Language (BQL). Developed by Tammo van Lessen, this implementation provides tools to set ledger files and run BQL queries against them, returning tabular results that can be used for financial analysis. The server exposes resources for discovering available tables and accounts in the ledger, making it easier for AI assistants to formulate relevant queries. Ideal for personal finance tracking, expense analysis, and generating financial reports from Beancount data without requiring direct access to the beanquery command-line tool.

## Trust

- **Trust score (0–1):** 0.50
- **Verification tier:** unverified

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** finance
- **Updated:** 2026-04-25

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/vanto-beanquery)
- **Repository:** <https://github.com/vanto/beanquery-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "vanto-beanquery"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/vanto-beanquery` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/vanto-beanquery/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt