YNAB MCP

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.

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