Lokaler Gmail-Reiniger ohne Versand von Korrespondenz an Drittanbieter-Server

Irgendwann öffnet jeder von uns seine E-Mail und sieht Zehntausende ungelesener Nachrichten. Rabatte von Geschäften, bei denen wir vor fünf Jahren etwas gekauft haben, Service-Digests, Aufgabenverfolgungs-Benachrichtigungen. Manuelle Bereinigung in Gmails eigener Oberfläche wird zum Albtraum, weil Googles Webclient große Auswahlmengen von mehr als 50–100 Nachrichten nur widerwillig verarbeitet.

Die meisten kommerziellen E-Mail-Bereinigungsprogramme arbeiten auf Abonnementbasis. Sie fordern vollständigen Kontozugriff und senden Ihre E-Mails zur Analyse an ihre eigenen Server. Der Autor des gmail-cleaner-Projekts verfolgte einen anderen Ansatz: Er schrieb ein leichtgewichtiges lokales Tool mit einer Weboberfläche, das ausschließlich auf Ihrem Rechner über die offizielle Gmail API funktioniert.

Warum die Bereinigung lokal ausführen

Die Hauptidee hinter dem Projekt ist vollständige Privatsphäre. Keine Drittanbieter-Backends, keine externen Datenbanken und keine kostenpflichtigen Tarife. Der gesamte Stack läuft lokal, und Ihre Daten gehen nirgendwo hin.

Die Anwendung löst vier häufige Probleme:

• Findet Newsletter und hilft Ihnen, mit einem Klick den Empfang zu beenden.
• Gruppiert E-Mails nach Absender und zeigt, wer Ihren Posteingang am meisten zumüllt.
• Löscht oder archiviert massenhaft Threads von ausgewählten Empfängern.
• Markiert Tausende von E-Mails innerhalb weniger Sekunden als gelesen.

Alle gelöschten E-Mails landen im standardmäßigen Papierkorb von Gmail. Wenn Sie versehentlich etwas löschen, das Sie benötigten, haben Sie 30 Tage Zeit, die Daten über Googles standardmäßige Weboberfläche wiederherzustellen.

Um die Arbeit zu beschleunigen, nutzt das Tool Gmail API-Batch-Anfragen und packt bis zu 100 Operationen in einen einzigen Aufruf. Deshalb dauert die Bereinigung mehrerer Tausend E-Mails nur minimale Zeit.

Was steckt drin und wie es funktioniert

Unter der Haube stecken Python 3.9+ und ein Webserver, der eine saubere Oberfläche im Stil von Gmail selbst bereitstellt.

Aus Sicherheitsperspektive erstellen Sie Ihre eigene Anwendung in der Google Cloud Console. Das bedeutet, dass die OAuth-Token Ihnen allein gehören und Berechtigungen nur für das minimal Notwendige angefordert werden: Lese- und Änderungszugriff zum Verschieben von Nachrichten in den Papierkorb und zum Ändern des Lesestatus.

Die Dateien credentials.json und token.json werden lokal gespeichert. Im Docker-Build wird ein separates Volume ./data für diesen Zweck bereitgestellt, sodass Sie nach einem Neustart des Containers keine erneute Autorisierung benötigen.

So stellen Sie das Projekt bereit

Der einfachste Weg, das Projekt auszuführen, ist über Docker. Für Liebhaber virtueller Umgebungen gibt es auch eine Option mit dem uv-Paketmanager.

Zuerst müssen Sie zur Google Cloud Console gehen, ein Projekt erstellen, die Gmail API aktivieren und eine OAuth-Client-ID generieren (Webanwendung für Docker oder Desktop-App für direkte Python-Ausführung). Fügen Sie unbedingt Ihre E-Mail zur Testbenutzerliste auf dem OAuth-Zustimmungsbildschirm hinzu.

Speichern Sie die heruntergeladene Datei als credentials.json im Projektstammverzeichnis.

Ausführung über Docker

Klonen Sie das Repository:

git clone https://github.com/Gururagavendra/gmail-cleaner.git
cd gmail-cleaner

Platzieren Sie die credentials.json-Datei daneben und starten Sie den Container:

docker compose pull && docker compose up

Öffnen Sie dann http://localhost:8766 in Ihrem Browser, klicken Sie auf die Anmeldeschaltfläche, rufen Sie den Google-Autorisierungslink aus den Container-Logs ab und bestätigen Sie den Zugriff.

Ausführung über Python und uv

Wenn Sie Docker nicht einrichten möchten, können Sie das Skript direkt über uv ausführen:

uv sync
uv run python main.py

Die Oberfläche ist unter der gleichen Adresse http://localhost:8766 verfügbar.

Filter und Datenexport

Über die einfache Bereinigung hinaus bietet das Projekt erweiterte Filter. Sie können E-Mails nach Anhangsgröße, Datumsbereich oder standardmäßigen Gmail-Kategorien (Werbung, Social, Updates, Foren, Primär) sortieren.

Wenn Sie Informationen über Absender und Daten bewahren müssen, bevor Sie alte Arbeitskorrespondenz löschen, kann die Oberfläche Metadaten in CSV exportieren.

Für wen ist das nützlich

Das Projekt ist ideal für jeden, dessen Posteingang die Marke von 50.000 Nachrichten überschritten hat und sich dem kostenlosen Speicherlimit von Google Drive nähert.

Ja, die Ersteinrichtung erfordert 5–10 Minuten Arbeit mit der Google Cloud Console und das Erstellen von OAuth-Schlüsseln. Aber als Gegenleistung erhalten Sie ein Tool, das Ihre E-Mails nicht auf Drittanbieter-Servern liest und für grundlegende Bereinigungsfunktionen kein monatliches Abonnement erfordert.