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

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.

  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.

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

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 bleibtAugust 2026
FixkostenStrom5,80Handy0,01Miete0,00AlltagLebensmittel207,49Mobilität45,00Restaurants30,90FreizeitTennis58,00Abos1,51SparzieleUrlaub200,00

Antwort von get_budget_vs_actual auf den Demo-Plan

Als Tabelle anzeigen
KategorieBudgetiertAusgegebenÜbrig
Fixkosten · Strom70,0064,205,80
Fixkosten · Handy20,0019,990,01
Fixkosten · Miete950,00950,000,00
Alltag · Lebensmittel400,00192,51207,49
Alltag · Mobilität90,0045,0045,00
Alltag · Restaurants120,0089,1030,90
Freizeit · Tennis80,0022,0058,00
Freizeit · Abos15,0013,491,51
Sparziele · Urlaub200,000,00200,00

Claude: Der August 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,
"actual": 950.0,
"balance": 0.0,
"utilization_pct": 100.0
},
{
"id": "cat-power",
"name": "Strom",
"group": "Fixkosten",
"budgeted": 70.0,
"actual": 64.2,
"balance": 5.8,
"utilization_pct": 91.7
},
{
"id": "cat-phone",
"name": "Handy",
"group": "Fixkosten",
"budgeted": 20.0,
"actual": 19.99,
"balance": 0.01,
"utilization_pct": 99.9
},
{
"id": "cat-groceries",
"name": "Lebensmittel",
"group": "Alltag",
"budgeted": 400.0,
"actual": 192.51,
"balance": 207.49,
"utilization_pct": 48.1
},
{
"id": "cat-restaurants",
"name": "Restaurants",
"group": "Alltag",
"budgeted": 120.0,
"actual": 89.1,
"balance": 30.9,
"utilization_pct": 74.2
},
{
"id": "cat-transport",
"name": "Mobilität",
"group": "Alltag",
"budgeted": 90.0,
"actual": 45.0,
"balance": 45.0,
"utilization_pct": 50.0
},
{
"id": "cat-tennis",
"name": "Tennis",
"group": "Freizeit",
"budgeted": 80.0,
"actual": 22.0,
"balance": 58.0,
"utilization_pct": 27.5
},
{
"id": "cat-subscriptions",
"name": "Abos",
"group": "Freizeit",
"budgeted": 15.0,
"actual": 13.49,
"balance": 1.51,
"utilization_pct": 89.9
},
{
"id": "cat-holidays",
"name": "Urlaub",
"group": "Sparziele",
"budgeted": 200.0,
"actual": 0.0,
"balance": 200.0,
"utilization_pct": 0.0
}
]

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

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