list_plans

Rôle

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.

Comportement


Nature	lecture seule
Confirmation	non
Annulation	non
Idempotent	oui
Requêtes YNAB	1 pour l’exemple ci-dessous, cache vide

Paramètres

aucun.

Retour

array of object

Champ	Type	Description
`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.

Exemple

Arguments :

{}

Réponse sur le budget de démonstration :

[
  {
    "id": "demo-budget",
    "name": "Foyer de démonstration",
    "first_month": "2026-06-01",
    "last_month": "2026-09-01"
  }
]

Erreurs

Cet outil ne lève pas d’erreur propre ; les erreurs de YNAB reviennent sous la forme Error calling tool '<tool>': YNAB <status>: <detail>.

Projet non officiel. « 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. » Nous ne sommes ni affiliés, ni associés, ni liés officiellement de quelque manière que ce soit à YNAB ou à ses filiales et sociétés affiliées. Le site officiel de YNAB se trouve à l’adresse https://www.ynab.com. Les noms YNAB et You Need A Budget, ainsi que les noms, dénominations commerciales, marques, emblèmes et images qui s’y rattachent, sont des marques déposées de YNAB. avenir-mcp est fourni tel quel, sans garantie, et n’est pas un conseil financier. Mentions légales · Confidentialité