Zum Inhalt springen

Inoffizieller Open-Source-MCP-Server für YNAB

Ihr YNAB-Plan, in klaren Worten.

Mit avenir-mcp können Claude und andere KI-Agenten Ihren Plan lesen, kategorisieren, abgleichen und vorausberechnen. Standardmäßig nur lesend; jede Änderung wird als Vorschau gezeigt, von Ihnen bestätigt und lässt sich rückgängig machen.

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

Funktioniert mitClaude CodeClaude DesktopCursorVS CodeGemini CLICodex CLILM Studio

17
Tools, jedes erledigt eine ganze Aufgabe
100 %
Zeilen- und Zweigabdeckung
9 / 9
Aufgaben von einem echten Agenten bestanden
1–2
YNAB-Anfragen pro Aufruf, bei den meisten Tools

Works with YNAB

Von YNAB in seinem Verzeichnis Works with YNAB unter den Apps von Drittanbietern aufgeführt. Ohne Befürwortung durch YNAB.

Ein 20-sekündiger Rundgang durch avenir-mcp: eine Frage zu einer überzogenen Kategorie, vier Tools, die den Plan gleichzeitig lesen, die genaue Korrektur in der Vorschau, bestätigt und rückgängig machbar, sowie der Befehl zur Installation von avenir-mcp.

Tools für Aufgaben, nicht für Endpunkte

Einen Monat Transaktionen kategorisieren, ein Konto mit der Bank abgleichen, den Kontostand vorausberechnen, einen Monat auswerten: Jede Aufgabe ist ein Tool, nicht zehn API-Aufrufe, die der Agent verketten muss.

Standardmäßig nur lesend

Die dreizehn schreibenden Tools sind weder aufgelistet noch aufrufbar, bis Sie AVENIR_MCP_WRITE=1 setzen. Ein Agent kann nicht ändern, was er nicht sieht.

Antworten, die ein Agent lesen kann

Währungseinheiten, niemals Milliunits. Typisierte Ausgabeschemas mit einer Beschreibung für jedes Feld, Paginierung und Fehler, die sagen, was zu korrigieren ist.

Schont das YNAB-Kontingent

Eine lokale Kopie Ihrer Transaktionen, per Delta-Synchronisation aktualisiert: Die meisten Tools kosten eine oder zwei der 200 Anfragen, die YNAB pro Stunde erlaubt.

Folgt der YNAB-API

Gebaut und getestet gegen die im Repository festgelegte Version der YNAB-API. Eine wöchentliche Prüfung vergleicht sie mit der Live-Spezifikation, damit eine Änderung bei YNAB nicht unbemerkt bleibt.

  1. 1

    Vorschau

    avenir-mcp berechnet die genaue Änderung und zeigt sie. Noch wird nichts geschrieben.

  2. 2

    Bestätigung

    Sie sagen Ja in Ihrem Client oder mit einem Einmalcode, der an diese Vorschau gebunden ist.

  3. 3

    Rückgängig

    Jede angewendete Änderung wird im Journal erfasst; das Rückgängigmachen stellt sie wieder her, ohne spätere Arbeit zu überschreiben.

Ein Gespräch in dreißig Sekunden. Auf die Frage, wie der Monat verläuft und wo noch Spielraum besteht, ruft der Agent gleichzeitig vier schreibgeschützte Tools auf: Month summary, Every category, Budget vs spent und Three months. Er antwortet, dass Restaurants die einzige Kategorie ist, die das Budget überschreitet: 166,50 ausgegeben von 144,00 verfügbar (120,00 budgetiert + 24,00 übrig aus früheren Monaten), 138,8 %, verfügbar −22,50; dass die Ausgaben dieser Kategorie über drei Monate hinweg von 113,70 → 119,90 → 166,50 gestiegen sind; und dass in der Kategorie Tennis noch 80,00 und in der Kategorie Groceries noch 411,90 übrig sind. Er schlägt vor, die 22,50 aus der Kategorie Tennis zu decken, in der noch keine Ausgaben getätigt wurden. Der Nutzer antwortet „Cover it from Tennis.“, und move_money zeigt eine Vorschau an, die nichts ändert: Budget der Kategorie Tennis 80,00 → 57,50, Budget der Kategorie Restaurants 120,00 → 142,50, verfügbar −22,50 → 0,00, genau im Rahmen des Budgets, mit einer Schaltfläche Cancel, einer Schaltfläche Confirm und dem Hinweis, dass sich nichts ändert, bis Sie bestätigen, und dass jede Änderung rückgängig gemacht werden kann.Ein Gespräch in dreißig Sekunden. Auf die Frage, wie der Monat verläuft und wo noch Spielraum besteht, ruft der Agent gleichzeitig vier schreibgeschützte Tools auf: Month summary, Every category, Budget vs spent und Three months. Er antwortet, dass Restaurants die einzige Kategorie ist, die das Budget überschreitet: 166,50 ausgegeben von 144,00 verfügbar (120,00 budgetiert + 24,00 übrig aus früheren Monaten), 138,8 %, verfügbar −22,50; dass die Ausgaben dieser Kategorie über drei Monate hinweg von 113,70 → 119,90 → 166,50 gestiegen sind; und dass in der Kategorie Tennis noch 80,00 und in der Kategorie Groceries noch 411,90 übrig sind. Er schlägt vor, die 22,50 aus der Kategorie Tennis zu decken, in der noch keine Ausgaben getätigt wurden. Der Nutzer antwortet „Cover it from Tennis.“, und move_money zeigt eine Vorschau an, die nichts ändert: Budget der Kategorie Tennis 80,00 → 57,50, Budget der Kategorie Restaurants 120,00 → 142,50, verfügbar −22,50 → 0,00, genau im Rahmen des Budgets, mit einer Schaltfläche Cancel, einer Schaltfläche Confirm und dem Hinweis, dass sich nichts ändert, bis Sie bestätigen, und dass jede Änderung rückgängig gemacht werden kann.

Kategorien, Beträge, Abgleiche und angelegte Transaktionen lassen sich alle rückgängig machen. Wie das funktioniert: Bestätigung und Journal und Rückgängig.

Die Tools liefern strukturierte Daten, auf die sich der Agent verlassen kann – und die er Ihnen in klare Worte fasst.

Sie: Wie lief der letzte Monat?

Der Agent ruft get_budget_vs_actual mit {"month": "2026-08-01"} auf und erhält für jede Kategorie, was budgetiert, was ausgegeben wurde und was übrig ist. Hier diese Antwort auf dem Demo-Plan, als Grafik:

Was in jeder Kategorie übrig bleibtLetzter Monat
FixkostenHausratversicherung315,00Miete0,00Strom0,00Internet0,00Handy0,00AlltagRestaurants24,00Lebensmittel11,90Mobilität0,00FreizeitTennis0,00Abos0,00SparzieleNotfallfonds1.200,00Urlaub600,00

Antwort von get_budget_vs_actual auf den Demo-Plan

Als Tabelle anzeigen
KategorieBudgetiertAusgegebenÜbrig
Fixkosten · Hausratversicherung105,000,00315,00
Fixkosten · Miete950,00950,000,00
Fixkosten · Strom64,2064,200,00
Fixkosten · Internet29,9929,990,00
Fixkosten · Handy19,9919,990,00
Alltag · Restaurants120,00119,9024,00
Alltag · Lebensmittel400,00397,6011,90
Alltag · Mobilität45,0045,000,00
Freizeit · Tennis22,0022,000,00
Freizeit · Abos13,4913,490,00
Sparziele · Notfallfonds400,000,001.200,00
Sparziele · Urlaub200,000,00600,00

Claude: Der letzte Monat blieb überall im Budget: Keine Kategorie ist überzogen. Die Rechnungen sind bezahlt, für Lebensmittel sind 207,49 übrig und für Tennis 58,00, und die 200,00 für den Urlaub sind unberührt.

Die Rohantwort
get_budget_vs_actual — Demo-Plan
[
{
"id": "cat-rent",
"name": "Miete",
"group": "Fixkosten",
"budgeted": 950.0,
"carried_over": 0.0,
"actual": 950.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-power",
"name": "Strom",
"group": "Fixkosten",
"budgeted": 64.2,
"carried_over": 0.0,
"actual": 64.2,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-internet",
"name": "Internet",
"group": "Fixkosten",
"budgeted": 29.99,
"carried_over": 0.0,
"actual": 29.99,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-phone",
"name": "Handy",
"group": "Fixkosten",
"budgeted": 19.99,
"carried_over": 0.0,
"actual": 19.99,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-insurance",
"name": "Hausratversicherung",
"group": "Fixkosten",
"budgeted": 105.0,
"carried_over": 210.0,
"actual": 0.0,
"balance": 315.0,
"utilization_pct": 0.0
},
{
"id": "cat-groceries",
"name": "Lebensmittel",
"group": "Alltag",
"budgeted": 400.0,
"carried_over": 9.5,
"actual": 397.6,
"balance": 11.9,
"utilization_pct": 99.4
},
{
"id": "cat-restaurants",
"name": "Restaurants",
"group": "Alltag",
"budgeted": 120.0,
"carried_over": 23.9,
"actual": 119.9,
"balance": 24.0,
"utilization_pct": 99.9
},
{
"id": "cat-transport",
"name": "Mobilität",
"group": "Alltag",
"budgeted": 45.0,
"carried_over": 0.0,
"actual": 45.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-tennis",
"name": "Tennis",
"group": "Freizeit",
"budgeted": 22.0,
"carried_over": 0.0,
"actual": 22.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-subscriptions",
"name": "Abos",
"group": "Freizeit",
"budgeted": 13.49,
"carried_over": 0.0,
"actual": 13.49,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-holidays",
"name": "Urlaub",
"group": "Sparziele",
"budgeted": 200.0,
"carried_over": 400.0,
"actual": 0.0,
"balance": 600.0,
"utilization_pct": 0.0
},
{
"id": "cat-buffer",
"name": "Notfallfonds",
"group": "Sparziele",
"budgeted": 400.0,
"carried_over": 800.0,
"actual": 0.0,
"balance": 1200.0,
"utilization_pct": 0.0
}
]

Jedes Beispiel in dieser Dokumentation ist eine echte Antwort von avenir-mcp auf einem erfundenen Demo-Plan.

Teilen Sie uns unter Discussions → Ideas mit, welche Frage Sie Ihrem Budget stellen möchten. Hilfe zur Verwendung von avenir-mcp finden Sie unter Discussions → Q&A. Geben Sie niemals einen tatsächlichen Betrag, ein echtes Konto oder Ihr Token an.

Inoffizielles Projekt. „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.“ Wir sind mit YNAB oder einer seiner Tochtergesellschaften oder verbundenen Unternehmen weder verbunden noch assoziiert noch in irgendeiner Weise offiziell verknüpft. Die offizielle Website von YNAB finden Sie unter https://www.ynab.com. Die Namen YNAB und You Need A Budget sowie zugehörige Namen, Handelsnamen, Zeichen, Marken, Embleme und Bilder sind eingetragene Marken von YNAB. avenir-mcp wird ohne Gewähr bereitgestellt und ist keine Finanzberatung. Rechtliche Hinweise · Datenschutz