Ir al contenido

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.

Tipo solo lectura
Confirmación no
Deshacer no
Idempotente sí
Peticiones a YNAB 1 para el ejemplo de abajo, con la caché vacía
Nombre Tipo Obligatorio Por defecto Descripción
plan_id string sí — YNAB plan id or ‘last-used’.
month string no "current" ISO month ‘YYYY-MM-01’ or ‘current’.

array of object

Campo Tipo Descripción
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.

Argumentos:

{
"plan_id": "demo-budget",
"month": "2026-09-01"
}

Respuesta sobre el presupuesto de demostración:

[
{
"id": "cat-rent",
"name": "Alquiler",
"group": "Facturas",
"budgeted": 950.0,
"carried_over": 0.0,
"actual": 950.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-power",
"name": "Luz",
"group": "Facturas",
"budgeted": 64.2,
"carried_over": 0.0,
"actual": 64.2,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-internet",
"name": "Fibra",
"group": "Facturas",
"budgeted": 29.99,
"carried_over": 0.0,
"actual": 29.99,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-phone",
"name": "Teléfono",
"group": "Facturas",
"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}'.

Los errores propios de YNAB llegan como Error calling tool '<tool>': YNAB <status>: <detail>.

Proyecto no oficial. «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.» No estamos afiliados, asociados ni conectados oficialmente de ninguna manera con YNAB ni con sus filiales o empresas afiliadas. El sitio web oficial de YNAB se encuentra en https://www.ynab.com. Los nombres YNAB y You Need A Budget, así como los nombres, nombres comerciales, marcas, emblemas e imágenes relacionados, son marcas registradas de YNAB. avenir-mcp se ofrece tal cual, sin garantía, y no es asesoramiento financiero. Aviso legal · Privacidad