Create Category Group
create_category_groupCreate a new category group in a YNAB budget to organize spending categories for better financial management.
Instructions
[1 API call] Create a new category group in a budget
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budget_id | No | Budget ID or 'last-used' | last-used |
| name | Yes | Category group name (max 50 characters) |
Implementation Reference
- src/tools/categories.ts:177-195 (handler)Registration and handler implementation for the create_category_group tool.
server.registerTool("create_category_group", { title: "Create Category Group", description: "[1 API call] Create a new category group in a budget", inputSchema: { budget_id: z.string().default("last-used").describe("Budget ID or 'last-used'"), name: z.string().max(50).describe("Category group name (max 50 characters)"), }, annotations: { readOnlyHint: false }, }, async ({ budget_id, name }) => { try { const response = await getClient().categories.createCategoryGroup(budget_id, { category_group: { name }, }); const g = response.data.category_group; return textResult(`Created category group "${g.name}"\nID: ${g.id}`); } catch (e: any) { return errorResult(e.message); } });