get_budget_vs_actual
Share of each category’s budget spent in a month, to see what is over or close.
Use it for “am I over budget?” or “which categories are nearly used up?”. Give month as the first day of a month, YYYY-MM-01; any other day is refused. ‘current’ is the month in progress, where a share under 100 may only mean the month is not over. Amounts in currency units, spending as a positive number; utilization_pct above 100 means over budget. carried_over says what the months before left in the category, so budgeted plus carried_over is what the month had to spend: a category can be over its budget and still have something left. For what is still available in each category use get_category_balances; for the month’s totals, get_monthly_summary; for the months before, get_spending_trends. One YNAB request; changes nothing.
Verhalten
Abschnitt betitelt „Verhalten“| Art | nur lesend |
| Bestätigung | nein |
| Rückgängig | nein |
| Idempotent | ja |
| YNAB-Anfragen | 1 für das Beispiel unten, leerer Cache |
Parameter
Abschnitt betitelt „Parameter“| Name | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
plan_id |
string | ja | — | YNAB plan id or ‘last-used’. |
month |
string | nein | "current" |
ISO month ‘YYYY-MM-01’ or ‘current’. |
Rückgabe
Abschnitt betitelt „Rückgabe“array of object
| Feld | Typ | Beschreibung |
|---|---|---|
id |
string | YNAB id of the category. |
name |
string | Category name. |
group |
string | Name of the category’s group, e.g. Fun for Tennis. |
budgeted |
number | Amount assigned to the category this month. |
carried_over |
number | What the months before left available in the category when this one started; zero when the category started the month on nothing. |
actual |
number | Amount spent this month, as a positive number. |
balance |
number | What is left: budgeted minus spent, plus what was carried over; negative when overspent. |
utilization_pct |
number | Spent as a share of budgeted, in percent; above 100 means overspent, 0 when nothing is budgeted. |
Beispiel
Abschnitt betitelt „Beispiel“Argumente:
{ "plan_id": "demo-budget", "month": "2026-09-01"}Antwort auf dem Demo-Budget:
[ { "id": "cat-rent", "name": "Miete", "group": "Fixkosten", "budgeted": 950.0, "carried_over": 0.0, "actual": 950.0, "balance": 0.0, "utilization_pct": 100.0 }, { "id": "cat-power", "name": "Strom", "group": "Fixkosten", "budgeted": 64.2, "carried_over": 0.0, "actual": 64.2, "balance": 0.0, "utilization_pct": 100.0 }, { "id": "cat-internet", "name": "Internet", "group": "Fixkosten", "budgeted": 29.99, "carried_over": 0.0, "actual": 29.99, "balance": 0.0, "utilization_pct": 100.0 }, { "id": "cat-phone", "name": "Handy", "group": "Fixkosten", "budgeted": 19.99, "carried_over": 0.0, "actual": 19.99, "balance": 0.0, "utilization_pct": 100.0 }, "… 8 more"]month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.
Fehler von YNAB selbst kommen als Error calling tool '<tool>': YNAB <status>: <detail> zurück.
Siehe auch
Abschnitt betitelt „Siehe auch“Inoffizielles Projekt. „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.“ Wir sind mit YNAB oder einer seiner Tochtergesellschaften oder verbundenen Unternehmen weder verbunden noch assoziiert noch in irgendeiner Weise offiziell verknüpft. Die offizielle Website von YNAB finden Sie unter https://www.ynab.com. Die Namen YNAB und You Need A Budget sowie zugehörige Namen, Handelsnamen, Zeichen, Marken, Embleme und Bilder sind eingetragene Marken von YNAB. avenir-mcp wird ohne Gewähr bereitgestellt und ist keine Finanzberatung. Rechtliche Hinweise · Datenschutz