monzo-mcp

MCP-Server für die Monzo Banking-API. Schreibgeschützter Zugriff auf Konten, Salden, Töpfe, Transaktionen und Ausgabenanalysen – alles über Claude Code oder einen beliebigen MCP-Client.

Im Gegensatz zu anderen Monzo-MCP-Implementierungen, die rohe Bearer-Token verwenden (die nach 6 Stunden ablaufen), verarbeitet dieser Server vollständiges OAuth mit automatischer Token-Aktualisierung.

Funktionen

• 7 schreibgeschützte Tools – keine Schreibvorgänge, kein Geldtransfer

• OAuth mit automatischer Aktualisierung – Token werden automatisch aktualisiert, keine manuelle Neugenerierung erforderlich

• Lokaler Transaktions-Cache – SQLite-Datenbank überdauert das 90-tägige SCA-Fenster von Monzo

• Ausgabenanalyse – Kategorienaufschlüsselung, Top-Händler, Vergleich von Monat zu Monat

• Transaktionssuche – Suche nach Händler, Beschreibung oder Notizen im zwischengespeicherten Verlauf

Related MCP server: monzo-mcp

Tools

Voraussetzungen

• Python 3.13+

• uv (empfohlen) oder pip

• Ein Monzo-Konto mit einem OAuth-Client, der unter developers.monzo.com registriert ist

Installation

git clone https://github.com/partymola/monzo-mcp.git
cd monzo-mcp
uv venv --python 3.13 .venv
uv pip install -e .

Einrichtung

1. Einen Monzo OAuth-Client registrieren

Gehen Sie zu developers.monzo.com und erstellen Sie einen OAuth-Client:

• Setzen Sie die Redirect-URL auf http://localhost:6600/callback

• Notieren Sie sich Ihre Client ID und Ihr Client Secret

2. Authentifizierung

monzo-mcp auth

Dies öffnet Ihren Browser für Monzo OAuth. Nach der Autorisierung müssen Sie den Login innerhalb von 5 Minuten in Ihrer Monzo-App bestätigen, um vollen Zugriff auf den Transaktionsverlauf zu erhalten (SCA-Fenster von Monzo).

3. Bei Claude Code registrieren

claude mcp add -s user monzo -- /path/to/monzo-mcp/.venv/bin/monzo-mcp

4. Erste Synchronisierung

Führen Sie in Claude Code monzo_sync aus, um den lokalen Transaktions-Cache zu füllen. Tun Sie dies unmittelbar nach der Authentifizierung, um das SCA-Fenster (bis zu 11 Monate Verlauf) zu nutzen.

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen (optional):

Anmeldedateien (erstellt durch monzo-mcp auth):

• config/monzo_client.json – OAuth Client ID und Secret

• config/monzo_tokens.json – Zugriffs- und Aktualisierungs-Token (automatisch aktualisiert)

Monzo SCA-Fenster

Die starke Kundenauthentifizierung (SCA) von Monzo begrenzt den Zugriff auf den Transaktionsverlauf:

• Innerhalb von 5 Minuten nach App-Bestätigung: bis zu ca. 11 Monate Verlauf

• Nach Ablauf des Fensters: nur die letzten 90 Tage

Der lokale SQLite-Cache bewahrt alle synchronisierten Transaktionen dauerhaft auf, führen Sie also monzo_sync zeitnah nach monzo-mcp auth aus.

Sicherheit

• Keine Schreib-Tools – kann kein Geld senden, keine Gelder zwischen Töpfen verschieben oder Transaktionen ändern

• Die Monzo-API selbst kann kein Geld an externe Konten senden

• Token werden als JSON-Dateien im Verzeichnis config/ gespeichert (gitignored)

• Alle API-Aufrufe sind GET-Anfragen mit Bearer-Token-Authentifizierung

Mitwirken

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung, den Test-Workflow und den Pre-Commit-Hook. Änderungen werden in CHANGELOG.md protokolliert.

Lizenz

GPL-3.0-or-later. Siehe LICENSE.