Ga naar inhoud

Onofficiële opensource-MCP-server voor YNAB

Je YNAB-plan, in gewone woorden.

Met avenir-mcp kunnen Claude en andere AI-agenten uw plan lezen, classificeren, afstemmen en voorspellen. Standaard is het systeem alleen-lezen; elke wijziging wordt eerst in een voorbeeld weergegeven, door u bevestigd en kan ongedaan worden gemaakt.

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

Werkt metClaude CodeClaude DesktopCursorVS CodeGemini CLICodex CLILM Studio

17
tools, elk voor een hele taak
100 %
dekking van regels en vertakkingen
9 / 9
taken gehaald door een echte agent
1–2
YNAB-verzoeken per aanroep, bij de meeste tools

Works with YNAB

Door YNAB opgenomen in zijn lijst Works with YNAB, bij de apps van derden. Niet onderschreven door YNAB.

Een rondleiding van 20 seconden door avenir-mcp: een vraag over een categorie die over budget is, vier tools die het plan gelijktijdig lezen, het exacte herstel in voorbeeld, bevestigd en ongedaan te maken, en de opdracht waarmee avenir-mcp wordt geïnstalleerd.

Hulpmiddelen voor taken, geen eindpunten

Een maand aan transacties classificeren, een rekening afstemmen met de bank, het saldo voorspellen, een maand evalueren: elk daarvan is één hulpmiddel, niet tien API-aanroepen die de agent achter elkaar moet uitvoeren.

Standaard alleen-lezen

De dertien schrijfhulpmiddelen worden pas weergegeven en kunnen pas worden aangeroepen nadat u de instellingen hebt geconfigureerd AVENIR_MCP_WRITE=1. Een agent kan niet wijzigen wat hij niet kan zien.

Antwoorden die een agent kan lezen

Valuta-eenheden, nooit milli-eenheden. Getypeerde uitvoerschema’s met een beschrijving voor elk veld, paginering en foutmeldingen die aangeven wat er moet worden gecorrigeerd.

Geringe belasting van het YNAB-quotum

Een lokale kopie van uw transacties, vernieuwd via delta-synchronisatie: de meeste tools kosten één of twee van de 200 verzoeken die YNAB per uur toestaat.

Volgt de API van YNAB

Gebouwd en getest op basis van de YNAB-API-versie die in de repository is vastgelegd. Een wekelijkse controle vergelijkt deze met de actuele specificatie, zodat een wijziging bij YNAB niet onopgemerkt kan blijven.

  1. 1

    Voorbeeld

    avenir-mcp berekent de exacte wijziging en laat die zien. Er wordt nog niets geschreven.

  2. 2

    Bevestiging

    Je zegt ja in je client, of met een eenmalige code die aan dat voorbeeld gekoppeld is.

  3. 3

    Ongedaan maken

    Elke toegepaste wijziging staat in het journaal; ongedaan maken herstelt haar zonder later werk te overschrijven.

Eén gesprek, in dertig seconden. Op de vraag hoe de maand verloopt en waar de ruimte nog zit, roept de agent tegelijkertijd vier alleen-lezen tools op: Month summary, Every category, Budget vs spent en Three months. De agent antwoordt dat Restaurants de enige categorie is die het budget overschrijdt: 166,50 uitgegeven van de beschikbare 144,00 (120,00 begroot + 24,00 overgebleven van eerdere maanden), 138,8 %, beschikbaar −22,50; dat de uitgaven van die categorie in drie maanden tijd zijn gestegen van 113,70 naar 119,90 naar 166,50; en dat er nog 80,00 over is bij Tennis en 411,90 bij Groceries. De agent stelt voor om de 22,50 te dekken uit de categorie Tennis, waar nog niets is uitgegeven. De gebruiker antwoordt ‘Cover it from Tennis.’, en move_money toont een voorbeeldweergave waarin niets verandert: budget van Tennis 80,00 → 57,50, budget van Restaurants 120,00 → 142,50, beschikbaar −22,50 → 0,00, precies binnen het budget, met een knop Cancel, een knop Confirm en de mededeling dat er niets verandert totdat u bevestigt en dat elke wijziging ongedaan kan worden gemaakt.Eén gesprek, in dertig seconden. Op de vraag hoe de maand verloopt en waar de ruimte nog zit, roept de agent tegelijkertijd vier alleen-lezen tools op: Month summary, Every category, Budget vs spent en Three months. De agent antwoordt dat Restaurants de enige categorie is die het budget overschrijdt: 166,50 uitgegeven van de beschikbare 144,00 (120,00 begroot + 24,00 overgebleven van eerdere maanden), 138,8 %, beschikbaar −22,50; dat de uitgaven van die categorie in drie maanden tijd zijn gestegen van 113,70 naar 119,90 naar 166,50; en dat er nog 80,00 over is bij Tennis en 411,90 bij Groceries. De agent stelt voor om de 22,50 te dekken uit de categorie Tennis, waar nog niets is uitgegeven. De gebruiker antwoordt ‘Cover it from Tennis.’, en move_money toont een voorbeeldweergave waarin niets verandert: budget van Tennis 80,00 → 57,50, budget van Restaurants 120,00 → 142,50, beschikbaar −22,50 → 0,00, precies binnen het budget, met een knop Cancel, een knop Confirm en de mededeling dat er niets verandert totdat u bevestigt en dat elke wijziging ongedaan kan worden gemaakt.

Categorieën, bedragen, afstemmingen en aangemaakte transacties kunnen allemaal ongedaan worden gemaakt. Hoe dit werkt: Bevestiging en Journaal en ongedaan maken.

Deze tools leveren gestructureerde gegevens op waarop de medewerker kan vertrouwen — en die voor u in begrijpelijke taal worden uitgelegd.

Jij: Hoe ging vorige maand?

De agent roept get_budget_vs_actual aan met {"month": "2026-08-01"} en krijgt voor elke categorie wat er gebudgetteerd, wat er uitgegeven en wat er over is. Hier dat antwoord op het demoplan, als grafiek:

Wat er in elke categorie overblijftVorige maand
Vaste lastenWoningverzekering315,00Huur0,00Stroom0,00Internet0,00Telefoon0,00DagelijksRestaurants24,00Boodschappen11,90Vervoer0,00Vrije tijdTennis0,00Abonnementen0,00SpaardoelenNoodfonds1.200,00Vakantie600,00

Antwoord van get_budget_vs_actual op het demoplan

Als tabel tonen
CategorieGebudgetteerdUitgegevenOver
Vaste lasten · Woningverzekering105,000,00315,00
Vaste lasten · Huur950,00950,000,00
Vaste lasten · Stroom64,2064,200,00
Vaste lasten · Internet29,9929,990,00
Vaste lasten · Telefoon19,9919,990,00
Dagelijks · Restaurants120,00119,9024,00
Dagelijks · Boodschappen400,00397,6011,90
Dagelijks · Vervoer45,0045,000,00
Vrije tijd · Tennis22,0022,000,00
Vrije tijd · Abonnementen13,4913,490,00
Spaardoelen · Noodfonds400,000,001.200,00
Spaardoelen · Vakantie200,000,00600,00

Claude: Vorige maand bleef overal binnen budget: geen enkele categorie zit over budget. De rekeningen zijn betaald, er is 207,49 over voor boodschappen en 58,00 voor tennis, en de 200,00 voor vakantie is onaangeroerd.

Het ruwe antwoord
get_budget_vs_actual — demoplan
[
{
"id": "cat-rent",
"name": "Huur",
"group": "Vaste lasten",
"budgeted": 950.0,
"carried_over": 0.0,
"actual": 950.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-power",
"name": "Stroom",
"group": "Vaste lasten",
"budgeted": 64.2,
"carried_over": 0.0,
"actual": 64.2,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-internet",
"name": "Internet",
"group": "Vaste lasten",
"budgeted": 29.99,
"carried_over": 0.0,
"actual": 29.99,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-phone",
"name": "Telefoon",
"group": "Vaste lasten",
"budgeted": 19.99,
"carried_over": 0.0,
"actual": 19.99,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-insurance",
"name": "Woningverzekering",
"group": "Vaste lasten",
"budgeted": 105.0,
"carried_over": 210.0,
"actual": 0.0,
"balance": 315.0,
"utilization_pct": 0.0
},
{
"id": "cat-groceries",
"name": "Boodschappen",
"group": "Dagelijks",
"budgeted": 400.0,
"carried_over": 9.5,
"actual": 397.6,
"balance": 11.9,
"utilization_pct": 99.4
},
{
"id": "cat-restaurants",
"name": "Restaurants",
"group": "Dagelijks",
"budgeted": 120.0,
"carried_over": 23.9,
"actual": 119.9,
"balance": 24.0,
"utilization_pct": 99.9
},
{
"id": "cat-transport",
"name": "Vervoer",
"group": "Dagelijks",
"budgeted": 45.0,
"carried_over": 0.0,
"actual": 45.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-tennis",
"name": "Tennis",
"group": "Vrije tijd",
"budgeted": 22.0,
"carried_over": 0.0,
"actual": 22.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-subscriptions",
"name": "Abonnementen",
"group": "Vrije tijd",
"budgeted": 13.49,
"carried_over": 0.0,
"actual": 13.49,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-holidays",
"name": "Vakantie",
"group": "Spaardoelen",
"budgeted": 200.0,
"carried_over": 400.0,
"actual": 0.0,
"balance": 600.0,
"utilization_pct": 0.0
},
{
"id": "cat-buffer",
"name": "Noodfonds",
"group": "Spaardoelen",
"budgeted": 400.0,
"carried_over": 800.0,
"actual": 0.0,
"balance": 1200.0,
"utilization_pct": 0.0
}
]

Elk voorbeeld in deze documentatie is een echt antwoord van avenir-mcp op een verzonnen demoplan.

Laat ons in Discussions → Ideas weten welke vraag u aan uw budget zou willen stellen. Hulp bij het gebruik van avenir-mcp vindt u onder Discussions → Q&A. Vermeld nooit een echt bedrag, een echte rekening of uw token.

Onofficieel project. “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.” We zijn op geen enkele manier verbonden, geassocieerd of officieel gelieerd aan YNAB of een van zijn dochterondernemingen of gelieerde bedrijven. De officiële website van YNAB vind je op https://www.ynab.com. De namen YNAB en You Need A Budget, evenals verwante namen, handelsnamen, merken, emblemen en afbeeldingen, zijn geregistreerde handelsmerken van YNAB. avenir-mcp wordt geleverd zoals het is, zonder garantie, en is geen financieel advies. Juridische informatie · Privacy