Ir al contenido

Servidor MCP no oficial y de código abierto para YNAB

Su plan de YNAB, en palabras claras.

avenir-mcp permite a Claude y a otros agentes de IA leer, clasificar, conciliar y prever su plan. Solo lectura por defecto; cada cambio se previsualiza, usted lo confirma, y se puede deshacer.

Terminal
claude mcp add avenir-mcp \
--env YNAB_API_KEY=su-token \
-- uvx avenir-mcp

Funciona conClaude CodeClaude DesktopCursorVS CodeGemini CLICodex CLILM Studio

17
herramientas, cada una hace una tarea completa
100 %
de cobertura de líneas y ramas
9 / 9
tareas superadas por un agente real
1–2
peticiones a YNAB por llamada, en la mayoría

Works with YNAB

Incluido por YNAB en su directorio Works with YNAB, entre las aplicaciones de terceros. Sin respaldo de YNAB.

Un recorrido de 20 segundos por avenir-mcp: una pregunta sobre una categoría excedida, cuatro herramientas que leen el plan a la vez, la solución exacta en vista previa, confirmada y que se puede deshacer, y el comando que instala avenir-mcp.

Herramientas para tareas, no para endpoints

Clasificar un mes de transacciones, conciliar una cuenta con el banco, prever el saldo, revisar un mes: cada tarea es una herramienta, no diez llamadas a la API que el agente deba encadenar.

Solo lectura por defecto

Las trece herramientas de escritura no se listan ni se pueden llamar hasta que defina AVENIR_MCP_WRITE=1. Un agente no puede cambiar lo que no ve.

Respuestas que un agente puede leer

Unidades monetarias, nunca miliunidades. Esquemas de salida tipados con una descripción por campo, paginación, y errores que dicen qué corregir.

Ligero con la cuota de YNAB

Una copia local de sus transacciones, actualizada por sincronización incremental: la mayoría de las herramientas cuestan una o dos de las 200 peticiones por hora de YNAB.

Sigue la API de YNAB

Construido y probado contra la versión de la API de YNAB fijada en el repositorio. Una comprobación semanal la compara con la especificación en vivo, para que un cambio en YNAB no pase inadvertido.

  1. 1

    Vista previa

    avenir-mcp calcula el cambio exacto y se lo muestra. Todavía no se escribe nada.

  2. 2

    Confirmación

    Usted dice que sí en su cliente, o con un código de un solo uso ligado a esa vista previa.

  3. 3

    Deshacer

    Cada cambio aplicado se anota en el diario; deshacer lo revierte sin sobrescribir el trabajo posterior.

Una conversación de treinta segundos. Al preguntarle cómo va el mes y dónde queda margen, el agente llama simultáneamente a cuatro herramientas de solo lectura: Month summary, Every category, Budget vs spent y Three months. Responde que Restaurants es la única categoría que supera el presupuesto: 166,50 gastados de los 144,00 disponibles (120,00 presupuestados + 24,00 restantes de meses anteriores), un 138,8 %, disponible −22,50; que su gasto ha aumentado de 113,70 a 119,90 y a 166,50 a lo largo de tres meses; y que quedan 80,00 en Tennis y 411,90 en Groceries. Propone cubrir los 22,50 con cargo a Tennis, donde aún no se ha gastado nada. El usuario responde «Cover it from Tennis.», y move_money muestra una vista previa en la que no cambia nada: presupuesto de Tennis 80,00 → 57,50, presupuesto de Restaurants 120,00 → 142,50, disponible −22,50 → 0,00, exactamente dentro del presupuesto, con un botón Cancel, un botón Confirm y el recordatorio de que nada cambia hasta que usted lo confirme y de que cualquier cambio se puede deshacer.Una conversación de treinta segundos. Al preguntarle cómo va el mes y dónde queda margen, el agente llama simultáneamente a cuatro herramientas de solo lectura: Month summary, Every category, Budget vs spent y Three months. Responde que Restaurants es la única categoría que supera el presupuesto: 166,50 gastados de los 144,00 disponibles (120,00 presupuestados + 24,00 restantes de meses anteriores), un 138,8 %, disponible −22,50; que su gasto ha aumentado de 113,70 a 119,90 y a 166,50 a lo largo de tres meses; y que quedan 80,00 en Tennis y 411,90 en Groceries. Propone cubrir los 22,50 con cargo a Tennis, donde aún no se ha gastado nada. El usuario responde «Cover it from Tennis.», y move_money muestra una vista previa en la que no cambia nada: presupuesto de Tennis 80,00 → 57,50, presupuesto de Restaurants 120,00 → 142,50, disponible −22,50 → 0,00, exactamente dentro del presupuesto, con un botón Cancel, un botón Confirm y el recordatorio de que nada cambia hasta que usted lo confirme y de que cualquier cambio se puede deshacer.

Categorías, importes, conciliaciones y transacciones creadas se pueden deshacer. Cómo funciona: Confirmación y Diario y deshacer.

Las herramientas devuelven datos estructurados en los que el agente puede confiar — y que este le explica con palabras sencillas.

Usted: ¿Cómo fue el mes pasado?

El agente llama a get_budget_vs_actual con {"month": "2026-08-01"} y recibe, para cada categoría, lo presupuestado, lo gastado y lo que queda. Esta es esa respuesta sobre el plan de demostración, en forma de gráfico:

Lo que queda en cada categoríaEl mes pasado
FacturasSeguro del hogar315,00Alquiler0,00Luz0,00Fibra0,00Teléfono0,00Día a díaRestaurantes24,00Supermercado11,90Transporte0,00OcioTenis0,00Suscripciones0,00Metas de ahorroFondo de emergencia1200,00Vacaciones600,00

Respuesta de get_budget_vs_actual sobre el plan de demostración

Ver como tabla
CategoríaPresupuestadoGastadoDisponible
Facturas · Seguro del hogar105,000,00315,00
Facturas · Alquiler950,00950,000,00
Facturas · Luz64,2064,200,00
Facturas · Fibra29,9929,990,00
Facturas · Teléfono19,9919,990,00
Día a día · Restaurantes120,00119,9024,00
Día a día · Supermercado400,00397,6011,90
Día a día · Transporte45,0045,000,00
Ocio · Tenis22,0022,000,00
Ocio · Suscripciones13,4913,490,00
Metas de ahorro · Fondo de emergencia400,000,001200,00
Metas de ahorro · Vacaciones200,000,00600,00

Claude: El mes pasado quedó dentro del presupuesto en todo: ninguna categoría está excedida. Las facturas están pagadas, quedan 207,49 para la compra y 58,00 para el tenis, y los 200,00 apartados para vacaciones siguen intactos.

La respuesta en bruto
get_budget_vs_actual — plan 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
},
{
"id": "cat-insurance",
"name": "Seguro del hogar",
"group": "Facturas",
"budgeted": 105.0,
"carried_over": 210.0,
"actual": 0.0,
"balance": 315.0,
"utilization_pct": 0.0
},
{
"id": "cat-groceries",
"name": "Supermercado",
"group": "Día a día",
"budgeted": 400.0,
"carried_over": 9.5,
"actual": 397.6,
"balance": 11.9,
"utilization_pct": 99.4
},
{
"id": "cat-restaurants",
"name": "Restaurantes",
"group": "Día a día",
"budgeted": 120.0,
"carried_over": 23.9,
"actual": 119.9,
"balance": 24.0,
"utilization_pct": 99.9
},
{
"id": "cat-transport",
"name": "Transporte",
"group": "Día a día",
"budgeted": 45.0,
"carried_over": 0.0,
"actual": 45.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-tennis",
"name": "Tenis",
"group": "Ocio",
"budgeted": 22.0,
"carried_over": 0.0,
"actual": 22.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-subscriptions",
"name": "Suscripciones",
"group": "Ocio",
"budgeted": 13.49,
"carried_over": 0.0,
"actual": 13.49,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-holidays",
"name": "Vacaciones",
"group": "Metas de ahorro",
"budgeted": 200.0,
"carried_over": 400.0,
"actual": 0.0,
"balance": 600.0,
"utilization_pct": 0.0
},
{
"id": "cat-buffer",
"name": "Fondo de emergencia",
"group": "Metas de ahorro",
"budgeted": 400.0,
"carried_over": 800.0,
"actual": 0.0,
"balance": 1200.0,
"utilization_pct": 0.0
}
]

Cada ejemplo de esta documentación es una respuesta real de avenir-mcp sobre un plan de demostración inventado.

¿Falta alguna pregunta? ¿Tiene alguna idea?

Sección titulada «¿Falta alguna pregunta? ¿Tiene alguna idea?»

Indíquenos la pregunta que le gustaría hacerle a su presupuesto en Discussions → Ideas. Encontrará ayuda sobre el uso de avenir-mcp en Discussions → Q&A. Nunca publique una cantidad real, una cuenta real ni su token.

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