ynab-mcp

Instructions

Implementation Reference

• src/tools/money-movements.ts:54-73 (handler)

  Implementation of the 'list_money_movement_groups' tool, which fetches and lists money movement groups for a YNAB budget using the money movements client.

  server.registerTool("list_money_movement_groups", {
    title: "List Money Movement Groups",
    description: "[1 API call] List all money movement groups for a budget",
    inputSchema: {
      budget_id: z.string().default("last-used").describe("Budget ID or 'last-used'"),
    },
    annotations: { readOnlyHint: true },
  }, async ({ budget_id }) => {
    try {
      const response = await getMoneyMovementsClient().getMoneyMovementGroups(budget_id);
      const groups = response.data.money_movement_groups;
      if (!groups || groups.length === 0) return textResult("No money movement groups found.");
      const lines = groups.map((g) =>
        `- ${g.month}: ${g.note ?? "No note"} (Created: ${g.group_created_at}) [ID: ${g.id}]`
      );
      return textResult(`Money Movement Groups (${groups.length}):\n${lines.join("\n")}`);
    } catch (e: any) {
      return errorResult(e.message);
    }
  });