YNAB MCP

YNAB Model Context Protocol (MCP)-Server für die Claude Code-Integration mit You Need A Budget (YNAB).

Überblick

Dieses Repository enthält einen Docker-basierten MCP-Server, der Claude Code die Interaktion mit YNAB-Konten (You Need A Budget) ermöglicht. Es implementiert den OAuth-Flow und bietet eine umfassende API für Budgetverwaltung, Transaktionsverfolgung und Finanzinformationen.

Related MCP server: ynab-mcp

Bekannte Probleme

Verfügbarkeit des MCP-Tools

Die folgenden Probleme wurden festgestellt:

1. Transactions API - Der Endpunkt list_transactions schlägt mit der Fehlermeldung „ungültiges Datum“ fehl, wenn der Parameter sinceDate verwendet wird

2. Fehlende API-Tools - Mehrere im Quellcode definierte Endpunkte sind in der MCP-Integration nicht verfügbar

3. Inkonsistentes Verhalten – Einige Tools funktionieren beim Testen mit test-mcp.js, schlagen aber bei der eigentlichen MCP-Integration fehl

Problemverfolgung

Wir arbeiten aktiv an den folgenden Fehlerbehebungen:

• fix-transactions-api Zweig: Adressierung der Datumsformatbehandlung in der Transaktions-API

• fix-mcp-registration : Sicherstellen, dass alle API-Tools ordnungsgemäß registriert und verfügbar sind

Merkmale

• OAuth-basierte Authentifizierung mit YNAB API

• Komplette Budget- und Kontoverwaltung

• Transaktionserstellung und -kategorisierung

• Erweitertes Kategoriemanagement mit Massenzuweisung und Empfehlungen

• Unterstützung mehrerer Budgets (persönlich und familiär)

• Handhabung der Ratenbegrenzung (YNAB-API-Begrenzung: 200 Anfragen/Stunde)

• Caching für verbesserte Leistung

Neue Funktionen zur Kategorieverwaltung

Dieses MCP umfasst erweiterte Funktionen zur Kategorieverwaltung:

• Zu Kategorien zuweisen : Ordnen Sie Gelder aus „Zuweisungsbereit“ in einem Vorgang mehreren Kategorien zu.

• Empfohlene Zuweisungen : Erhalten Sie KI-gestützte Vorschläge zur Budgetverteilung basierend auf Zielen und Ausgabenmustern

Weitere Einzelheiten finden Sie in der Dokumentation zur Kategorieverwaltung .

Erste Schritte

Voraussetzungen

• Docker

• Node.js v18+ (für die Entwicklung)

• Claude Code CLI

• YNAB-Konto

Installation

1. Dieses Repository klonen

2. Kopieren Sie config/config.example.js nach config/config.js und fügen Sie Ihre YNAB-API-Anmeldeinformationen hinzu

3. Erstellen Sie das Docker-Image: docker build -t ynab-mcp:latest .

4. Erstellen Sie eine JSON-Konfiguration für Claude:

   {
     "command": "docker",
     "args": [
       "run",
       "--rm",
       "-i",
       "-v",
       "/path/to/data:/app/data",
       "-v",
       "/path/to/config:/app/config",
       "-e",
       "NODE_ENV=production",
       "ynab-mcp:latest"
     ]
   }

5. Registrieren Sie das MCP mit Claude Code CLI:

   claude mcp add-json ynab '{"command": "docker", "args": ["run", "--rm", "-i", "-v", "/path/to/data:/app/data", "-v", "/path/to/config:/app/config", "-e", "NODE_ENV=production", "ynab-mcp:latest"]}'

   Sie können das JSON auch in einer Datei speichern und Folgendes verwenden:

   claude mcp add-json ynab "$(cat config.json)"

6. Authentifizieren Sie sich mit Ihrem YNAB-Konto, wenn Sie von Claude dazu aufgefordert werden

Integration mit Claude

Dieses MCP lässt sich nahtlos in Claude integrieren und ermöglicht:

• Anzeigen von Budgets und Transaktionen

• Finanzielle Einblicke erhalten

• Verwalten Sie Ihr Budget durch natürliche Konversation

Sicherheit

• Token werden sicher in einem gemounteten Docker-Volume gespeichert

• Es werden keine sensiblen Daten protokolliert

• Die Authentifizierung erfolgt über OAuth 2.0-Standards

• Unterstützung für den Nur-Lese-Modus

Implementierungsdetails

Die Implementierung folgt dem Model Context Protocol-Standard unter Verwendung von:

• Node.js und das offizielle MCP SDK

• Docker für Containerisierung und Bereitstellung

• YNAB JavaScript SDK für API-Operationen

• OAuth 2.0 zur Authentifizierung

Lizenz

MIT

Danksagung

• YNAB-API

• YNAB JavaScript-Bibliothek

• Anthropischer Claude