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 .