list_plans

Qué hace

List all YNAB plans accessible with the current API key.

A plan is what YNAB now calls a budget, and what users may still call their budget. Use the plan id in subsequent tool calls. ‘last-used’ also works, but names whichever plan was last opened in YNAB: with several plans, pass the id.

Comportamiento


Tipo	solo lectura
Confirmación	no
Deshacer	no
Idempotente	sí
Peticiones a YNAB	1 para el ejemplo de abajo, con la caché vacía

Parámetros

ninguno.

Devuelve

array of object

Campo	Tipo	Descripción
`id`	string	YNAB id of the plan, to pass as plan_id.
`name`	string	Plan name.
`first_month`	string \| null	First month with data, YYYY-MM-01; null for an empty plan.
`last_month`	string \| null	Last month with data, YYYY-MM-01; null for an empty plan.

Ejemplo

Argumentos:

{}

Respuesta sobre el presupuesto de demostración:

[
  {
    "id": "demo-budget",
    "name": "Hogar de demostración",
    "first_month": "2026-06-01",
    "last_month": "2026-09-01"
  }
]

Errores

Esta herramienta no lanza errores propios; los errores 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