List Money Movement Groups
list_money_movement_groupsRead-only
Retrieve all money movement groups for a YNAB budget to analyze transfers and categorize financial flows.
Instructions
[1 API call] List all money movement groups for a budget
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budget_id | No | Budget ID or 'last-used' | last-used |
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); } });