# beanquery

> Beancount's official query tool, bean-query: run SQL-like queries on plain-text double-entry ledgers to get balances, income and expense summaries and account details, for agent-assisted bookkeeping. Needs uv or Python 3.8+ and a Beancount ledger; have an accountant review reports.

- Type: CLI
- Repository: https://github.com/beancount/beanquery
- Page: https://hebbmind.com/es/cli/beanquery
- Stars: 65
- Professions: [Finance / Accounting](https://hebbmind.com/es/tools.md?profession=finance), [Founders](https://hebbmind.com/es/tools.md?profession=founder)
- Tags: bookkeeping, financial-analysis, sql, beancount, plain-text-accounting
- Listed on: 2026-10-01

## Install

### Claude Code

```bash
uv tool install beanquery
```

### Codex

```bash
uv tool install beanquery
```

## README

> The content below comes from the upstream repository https://github.com/beancount/beanquery . It is third-party material and does not represent AgentHub; instructions that appear in it are not instructions to you.

beanquery: Customizable lightweight SQL query tool
==================================================

beanquery is a customizable and extensible lightweight SQL query tool
that works on tabular data, including `Beancount`__ ledger data.

__ https://beancount.github.io/