MoneyMoney MCP Server

Lass deinen KI-Assistenten deine Finanzen aus MoneyMoney auswerten: Kontostände, Umsätze, Kategorien, Budgets und Depot, per natürlicher Sprache. Der Server liest standardmäßig nur. Optional kann er Überweisungen vorbereiten; abschicken kannst nur du selbst, mit TAN in MoneyMoney.

Inoffizielles Community-Projekt, nicht von der MRH applications GmbH entwickelt oder unterstützt. MoneyMoney ist eine eingetragene Marke der MRH applications GmbH.

Was kann man damit machen?

Schnellstart

Voraussetzungen

• macOS mit MoneyMoney, gestartet und entsperrt
• Node.js 20 oder neuer (node --version). Für die Claude-Desktop-Erweiterung nicht nötig, Claude Desktop bringt sein eigenes Node.js mit.

Beim ersten Zugriff fragt macOS, ob dein KI-Programm (z. B. Claude, Cursor oder das Terminal) MoneyMoney steuern darf. Erlaube das. Ändern kannst du es später unter Systemeinstellungen → Datenschutz & Sicherheit → Automation.

Einrichtung

In Claude Desktop installierst du den Server am einfachsten als Erweiterung. Alle anderen Clients starten ihn mit npx -y moneymoney-mcp, eine separate Installation ist nicht nötig.

claude mcp add --scope user moneymoney -- npx -y moneymoney-mcp

--scope user macht den Server in allen Projekten verfügbar. Ohne die Option gilt er nur im aktuellen Ordner.

Als Erweiterung, ohne Node.js:

1. moneymoney-mcp.mcpb herunterladen.
2. Die Datei per Doppelklick öffnen und in Claude Desktop auf „Installieren" klicken.

Danach steht die Erweiterung unter Einstellungen → Erweiterungen. Dort kannst du auch das Vorbereiten von Überweisungen einschalten (siehe unten). Neue Versionen gibt es unter demselben Link.

Alternativ über die JSON-Konfiguration (braucht Node.js): Einstellungen → Entwickler → „Konfiguration bearbeiten" öffnet ~/Library/Application Support/Claude/claude_desktop_config.json. Dort eintragen:

{
  "mcpServers": {
    "moneymoney": {
      "command": "npx",
      "args": ["-y", "moneymoney-mcp"]
    }
  }
}

Danach Claude Desktop ganz beenden (⌘Q) und neu starten.

Oder von Hand in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "moneymoney": {
      "command": "npx",
      "args": ["-y", "moneymoney-mcp"]
    }
  }
}

code --add-mcp '{"name":"moneymoney","type":"stdio","command":"npx","args":["-y","moneymoney-mcp"]}'

Oder über die Befehlspalette: „MCP: Add Server…". Der frühere Eintrag "mcp" in der settings.json wird nicht mehr gelesen.

codex mcp add moneymoney -- npx -y moneymoney-mcp

Das schreibt in ~/.codex/config.toml. Der erste Start über npx kann länger dauern als Codex' Standard-Wartezeit von 10 Sekunden. Falls der Server nicht startet, dort ergänzen:

[mcp_servers.moneymoney]
command = "npx"
args = ["-y", "moneymoney-mcp"]
startup_timeout_sec = 30

gemini mcp add -s user moneymoney npx -y moneymoney-mcp

Die meisten Clients verstehen denselben Block wie Claude Desktop (mcpServers mit command und args):

• Windsurf: ~/.codeium/windsurf/mcp_config.json, im Nachfolger Devin Desktop ~/.config/devin/mcp_config.json
• LM Studio: Programm → Install → „Edit mcp.json"
• Zed: in ~/.config/zed/settings.json unter context_servers:

{
  "context_servers": {
    "moneymoney": { "command": "npx", "args": ["-y", "moneymoney-mcp"] }
  }
}

Überweisungen vorbereiten (optional)

Ohne weitere Angabe ist der Server rein lesend. Das Tool create_bank_transfer kommt nur dazu, wenn du es einschaltest.

Claude-Desktop-Erweiterung: unter Einstellungen → Erweiterungen → MoneyMoney MCP den Schalter „Allow preparing transfers" einschalten.

Andere Clients: den Schalter --enable-transfers an die Argumente hängen:

claude mcp add --scope user moneymoney -- npx -y moneymoney-mcp --enable-transfers

In JSON-Konfigurationen sieht das so aus: "args": ["-y", "moneymoney-mcp", "--enable-transfers"]. Wo sich keine Argumente anhängen lassen, wirkt die Umgebungsvariable MONEYMONEY_ENABLE_TRANSFERS=true (oder 1) genauso, in JSON "env": { "MONEYMONEY_ENABLE_TRANSFERS": "true" }. Jeder andere Wert lässt den Server rein lesend.

Das Tool öffnet in MoneyMoney ein vorausgefülltes Überweisungsfenster. Es wird nichts gesendet, bis du die Überweisung dort prüfst und mit TAN bestätigst. Die Option von MoneyMoney, Überweisungen still in den Ausgangskorb zu legen, nutzt der Server nicht. IBAN-Prüfsumme, Betrag und SEPA-Feldlängen werden vorher geprüft.

Tools

Zeiträume über mehrere Jahre funktionieren. Der Server holt sie jahresweise ab, damit auch große Datenbanken nicht an Zeit- oder Speichergrenzen stoßen. Rechne mit einigen Sekunden pro Jahr.

Sicherheit und Datenschutz

• Nur lesend, solange du nichts anderes einschaltest. Das Überweisungs-Tool gibt es nur mit dem Schalter in der Erweiterung, --enable-transfers oder MONEYMONEY_ENABLE_TRANSFERS=true, und auch dann schickt es nichts ab.
• Deine Daten gehen an deinen KI-Anbieter. Der Server selbst baut keine Netzwerkverbindung auf. Was ein Tool zurückgibt, landet aber im Chat und damit beim Anbieter des Modells (z. B. Anthropic, OpenAI, Google), außer du nutzt ein lokales Modell. Frag nur nach dem, was du teilen möchtest.
• Deine Kontonummern sind maskiert. In der Kontenliste bleiben nur Ländercode und die letzten vier Stellen sichtbar. Die vollen Nummern gibt es nur mit includeSensitive; solche Aufrufe zeigt dir dein Client an. Die IBAN der Gegenseite gibt der Server nicht aus. Umsatztexte wie der Verwendungszweck kommen aber so, wie sie in MoneyMoney stehen, und können Namen, Adressen oder auch eine IBAN enthalten.
• Umsatztexte stammen von Fremden. Jeder, der dir Geld überweist, bestimmt den Verwendungszweck und könnte dort Anweisungen an KI-Assistenten verstecken. Der Server weist das Modell an, solche Texte nur als Daten zu behandeln. Prüfe trotzdem jede vorgeschlagene Überweisung selbst.
• Keine Code-Einschleusung. Alle Werte (Kontonamen, Suchtexte, IBANs) gehen als Argumente an AppleScript und nie als Teil des Skripts.
• Export-Dateien liegen in einem eigenen temporären Ordner, den nur dein Benutzer lesen kann. macOS räumt ihn nach einigen Tagen auf.
• Open Source, der gesamte Code ist einsehbar.

Fehlerbehebung

Entwicklung

git clone https://github.com/pipamann/moneymoney-mcp.git
cd moneymoney-mcp
npm install
npm run build
npm test

Die Tests brauchen Node.js 22.18 oder neuer, weil Node die TypeScript-Dateien direkt ausführt. MoneyMoney wird dafür nicht benötigt. Die mitgelieferte .mcp.json bindet den lokalen Build in Claude Code ein.

npm run pack:mcpb baut, testet und packt die Claude-Desktop-Erweiterung moneymoney-mcp.mcpb, mit dem kompilierten Server und nur den Laufzeit-Abhängigkeiten. Die Datei gehört unter genau diesem Namen ins GitHub-Release, damit der Download-Link oben immer auf die neueste Version zeigt. Bei einer neuen Version auch version in manifest.json anpassen; ein Test prüft, dass sie zu package.json passt.

Lizenz

MIT, siehe LICENSE. Änderungen stehen im CHANGELOG.

Dieses Projekt ist ein unabhängiges Open-Source-Projekt und steht in keiner Verbindung zur MRH applications GmbH oder der Software MoneyMoney. Der Name „MoneyMoney" wird ausschließlich zur Beschreibung der Kompatibilität verwendet.