list_accounts
List GnuCash chart of accounts with subtree and text filters. Get paginated results and account IDs for use in transactions, budgets, and reports.
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 true, return full JSON details for each account.
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 |