Monarch Money MCP-Server

A Model Context Protocol (MCP)-Server zur Integration der persönlichen Finanzplattform Monarch Money über Claude Desktop.

Übersicht

• Sicher durch Design — browserbasierte Anmeldung, Token-Speicherung im OS-Schlüsselbund (niemals in Konfigurationsdateien oder Umgebungsvariablen)

• Sicher durch Standardeinstellungen — der schreibgeschützte Modus verhindert versehentliche Änderungen; Schreib-Tools erfordern eine explizite Zustimmung

• Umfassend — 37 Tools für Konten, Transaktionen, Splits, Budgets, Cashflow, Tags, Kategorien und Kredithistorie

• Einfache Installation — Claude Desktop-Erweiterung (.mcpb), uvx oder pip

Zwei Betriebsmodi:

Der Server startet standardmäßig im schreibgeschützten Modus. Schreib-Tools sind ausgeblendet und blockiert, bis Sie diese explizit aktivieren.

Related MCP server: Monarch Money MCP Server

Schnellstart

Installation

Option 1: Claude Desktop-Erweiterung (.mcpb) — Empfohlen für Claude Desktop

Ermöglicht das Ein- und Ausschalten des Schreibmodus direkt aus der Claude Desktop-App.

1. Laden Sie die neueste .mcpb von den Releases herunter

2. In Claude Desktop: Einstellungen > Erweiterungen > Erweiterte Einstellungen > Erweiterungen installieren — wählen Sie die .mcpb-Datei aus

3. Starten Sie Claude Desktop neu

Um Schreib-Tools zu aktivieren: Einstellungen > Erweiterungen > Monarch Money MCP Server > Konfigurieren — aktivieren Sie "Schreib-Tools aktivieren" und klicken Sie auf Speichern.

Option 2: uvx (keine Installation erforderlich) — Empfohlen für Agenten (z. B. Claude Code oder Cursor)

Funktioniert auch mit Claude Desktop, aber der Schreibmodus kann nicht über die App umgeschaltet werden — legen Sie ihn stattdessen in der Konfiguration fest.

Fügen Sie dies Ihrer MCP-Konfigurationsdatei hinzu:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp"]
    }
  }
}

Um Schreib-Tools zu aktivieren:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp", "--enable-write"]
    }
  }
}

Option 3: pip-Installation — Empfohlen für lokale Installation und venv

pip install monarch-mcp

Mitwirkende: Siehe docs/releasing.md für den Release-Prozess, das Versionsschema und Vorab-Tests über TestPyPI.

Fügen Sie dies Ihrer MCP-Konfiguration unter Verwendung des vollständigen Pfads zu Ihrem Python-Interpreter hinzu:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

Um Schreib-Tools zu aktivieren, fügen Sie "--enable-write" zu args hinzu.

Option 4: Klonen und installieren — Empfohlen für die Entwicklung

git clone https://github.com/vargahis/monarch-mcp.git
cd monarch-mcp
pip install -e .

Fügen Sie dies dann Ihrer MCP-Konfiguration unter Verwendung des Python-Interpreters aus Ihrer Entwicklungsumgebung hinzu:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

Um Schreib-Tools zu aktivieren, fügen Sie "--enable-write" zu args hinzu.

Authentifizierung

Die Authentifizierung erfolgt automatisch in Ihrem Browser, wenn der MCP-Server zum ersten Mal ohne gespeicherte Sitzung startet.

1. Starten (oder neu starten) Sie Claude Desktop

2. Der Server erkennt, dass kein Token vorhanden ist, und öffnet eine Anmeldeseite in Ihrem Browser

3. Geben Sie Ihre Monarch Money-E-Mail-Adresse und Ihr Passwort ein

4. Geben Sie Ihren 2FA-Code ein, falls Sie MFA aktiviert haben

5. Sobald die Authentifizierung erfolgreich war, wird das Token im System-Schlüsselbund gespeichert — Sie sind startklar

Wichtige Details:

• Anmeldedaten werden nur in Ihrem Browser eingegeben — niemals über Claude Desktop

• Token wird im OS-Schlüsselbund gespeichert — bleibt über Neustarts hinweg erhalten und hält Wochen/Monate

• Abgelaufene Sitzungen authentifizieren sich automatisch neu — die Browser-Anmeldung wird beim nächsten Tool-Aufruf erneut ausgelöst

• MFA wird vollständig unterstützt

• Fallback: Führen Sie python login_setup.py in einem Terminal für Headless-Umgebungen aus

Technische Details zur Authentifizierungsarchitektur finden Sie unter docs/authentication.md.

Anwendungsbeispiele

Show me all my financial accounts

What were my last 50 transactions?

How's my budget looking this month?

Analyze my cashflow for the last 3 months

Create a tag called "Business Expenses" in red

Verfügbare Tools

🙏 Danksagungen

Ein Fork von @robcerdas monarch-mcp-server, gewartet von vargahis.

Aufgebaut auf der Python-Bibliothek monarchmoneycommunity.

Dank an:

• @robcerda für den ursprünglichen MCP-Server

• @hammem für die ursprüngliche monarchmoney-Bibliothek

• @bradleyseanf für den Community-Fork

Lizenz

MIT-Lizenz