ynab-mcp

Instructions

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);
    }
  });