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

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.

  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.

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 agosto?

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íaagosto de 2026
FacturasAlquiler0,00Luz0,00Fibra0,00Teléfono0,00Día a díaSupermercado207,49Transporte45,00Restaurantes30,90OcioTenis58,00Suscripciones0,00Metas de ahorroVacaciones200,00

Respuesta de get_budget_vs_actual sobre el plan de demostración

Ver como tabla
CategoríaPresupuestadoGastadoDisponible
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 · Supermercado400,00192,51207,49
Día a día · Transporte90,0045,0045,00
Día a día · Restaurantes120,0089,1030,90
Ocio · Tenis80,0022,0058,00
Ocio · Suscripciones13,4913,490,00
Metas de ahorro · Vacaciones200,000,00200,00

Claude: Agosto 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,
"actual": 950.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-power",
"name": "Luz",
"group": "Facturas",
"budgeted": 64.2,
"actual": 64.2,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-internet",
"name": "Fibra",
"group": "Facturas",
"budgeted": 29.99,
"actual": 29.99,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-phone",
"name": "Teléfono",
"group": "Facturas",
"budgeted": 19.99,
"actual": 19.99,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-groceries",
"name": "Supermercado",
"group": "Día a día",
"budgeted": 400.0,
"actual": 192.51,
"balance": 207.49,
"utilization_pct": 48.1
},
{
"id": "cat-restaurants",
"name": "Restaurantes",
"group": "Día a día",
"budgeted": 120.0,
"actual": 89.1,
"balance": 30.9,
"utilization_pct": 74.2
},
{
"id": "cat-transport",
"name": "Transporte",
"group": "Día a día",
"budgeted": 90.0,
"actual": 45.0,
"balance": 45.0,
"utilization_pct": 50.0
},
{
"id": "cat-tennis",
"name": "Tenis",
"group": "Ocio",
"budgeted": 80.0,
"actual": 22.0,
"balance": 58.0,
"utilization_pct": 27.5
},
{
"id": "cat-subscriptions",
"name": "Suscripciones",
"group": "Ocio",
"budgeted": 13.49,
"actual": 13.49,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-holidays",
"name": "Vacaciones",
"group": "Metas de ahorro",
"budgeted": 200.0,
"actual": 0.0,
"balance": 200.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.

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