list_accounts
List GnuCash accounts with filtering by root or query, pagination, and compact or verbose output.
Instructions
List all accounts in the GnuCash chart of accounts.
Leads with a Showing X-Y of Z accounts line, then a compact
one-line-per-account format by default. Page with offset;
limit=0 returns the count only. Use verbose=true for full
JSON with guid, type, commodity, etc.
To FIND an account without paging the whole chart, pass
query — a case-insensitive substring matched against each
account's full path and description (e.g. query="grocer" or
query="4930" on a numbered chart). Results emit %short GUIDs
that every account-taking tool accepts. For searching
transactions by text or amount, use search_transactions.
Args:
root: Filter to a subtree (e.g., "Expenses" for expense accounts only).
verbose: If false (default), compact text output — optimized
for reading and token efficiency. If true, structured
JSON, for when you need machine-readable fields rather
than a report.
limit: Page size (default 50, max 250). 0 = count only.
offset: 0-indexed first row to return (default 0).
query: Case-insensitive substring filter on account
path/description. Combines with root.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root | No | ||
| limit | No | ||
| query | No | ||
| offset | No | ||
| verbose | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |