list_category_groups
What it does
Section titled “What it does”List the category groups a category can be created in or moved to.
A group is a heading over categories: it holds no amount of its own, so nothing here says what was budgeted or spent. A group id goes to create_category, or to update_category as category_group_id. For the money in each category use get_category_balances; to classify transactions, suggest_categories. With several plans, pass the plan id from list_plans: ‘last-used’ follows the plan last opened in YNAB. Hidden, deleted and system groups are left out. One YNAB request; changes nothing.
Behaviour
Section titled “Behaviour”| Kind | read-only |
| Confirmation | no |
| Undo | no |
| Idempotent | yes |
| YNAB requests | 1 for the example below, on a cold cache |
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
plan_id |
string | yes | — | YNAB plan id or ‘last-used’. |
Returns
Section titled “Returns”array of object
| Field | Type | Description |
|---|---|---|
id |
string | YNAB id of the group, to pass as category_group_id. |
name |
string | Group name. |
Example
Section titled “Example”Arguments:
{ "plan_id": "demo-budget"}Answer on the demo budget:
[ { "id": "grp-bills", "name": "Bills" }, { "id": "grp-everyday", "name": "Everyday" }, { "id": "grp-fun", "name": "Fun" }, { "id": "grp-savings-goals", "name": "Savings goals" }]Errors
Section titled “Errors”This tool raises no error of its own; YNAB’s errors come back as Error calling tool '<tool>': YNAB <status>: <detail>.
Unofficial project. We are not affiliated, associated, or in any way officially connected with YNAB or any of its subsidiaries or affiliates. The official YNAB website can be found at https://www.ynab.com. The names YNAB and You Need A Budget, as well as related names, tradenames, marks, trademarks, emblems, and images are registered trademarks of YNAB. avenir-mcp is provided as is, without warranty, and is not financial advice. Legal notice · Privacy