MCP YNAB Server

Eine MCP-Serverimplementierung, die über das Model Context Protocol Zugriff auf die YNAB-Funktionalität (You Need A Budget) bietet.

Merkmale

Kontostände und Transaktionen anzeigen
Neue Transaktionen erstellen
Zugriff auf YNAB-Daten über standardisierte MCP-Ressourcen

Related MCP server: YNAB MCP Server

Installation

uv pip install -e .

Konfiguration

Der Server benötigt einen YNAB-API-Schlüssel. Sie erhalten einen in Ihren YNAB-Entwicklereinstellungen .

Der API-Schlüssel kann bereitgestellt werden über:

Umgebungsvariable: YNAB_API_KEY=your_api_key
MCP-Geheimnisverwaltungssystem
.env -Datei im Projektstamm

Verwendung

Ausführen des Servers

# Development mode with hot reload and browser launch task dev # Production install for Claude Desktop, Goose, or any other MCP-supported environment task install

Verfügbare Ressourcen

ynab://accounts – Alle YNAB-Konten auflisten
ynab://transactions/{account_id} – Aktuelle Transaktionen für ein bestimmtes Konto abrufen

Verfügbare Tools

create_transaction - Neue Transaktion erstellen
get_account_balance - Aktuellen Kontostand abrufen

Beispielverwendung

# Create a new transaction result = await create_transaction( account_id="your_account_id", amount=42.50, # in dollars payee_name="Coffee Shop", category_name="Dining Out", memo="Morning coffee" ) # Get account balance balance = await get_account_balance("your_account_id") # List accounts accounts = await ctx.read_resource("ynab://accounts") # Get recent transactions transactions = await ctx.read_resource(f"ynab://transactions/{account_id}")

Entwicklung

# Install dependencies (uses uv) task deps # Run all tests including integration tests (you will need a YNAB API key for this) task test:all # Generate coverage report task coverage # Format and lint code task fmt # Should add this to Taskfile

Projektaufgaben

Dieses Projekt verwendet eine Taskdatei für allgemeine Vorgänge. Tastenbefehle:

task dev # Start dev server with auto-reload task test # Run unit tests task coverage # Generate test coverage report task install # Install production build task deps # Synchronize dependencies

Alle verfügbaren Aufgaben finden Sie in Taskfile.yml .