Nettoyeur Gmail local sans envoi de correspondance vers des serveurs tiers

À un moment donné, chacun d'entre nous ouvre sa boîte mail et voit des dizaines de milliers de messages non lus. Des réductions de magasins où nous avons acheté quelque chose il y a cinq ans, des résumés de services, des notifications de gestionnaires de tâches. Le nettoyage manuel dans l'interface native de Gmail devient un cauchemar car le client web de Google gère mal les sélections de plus de 50 à 100 messages à la fois.

La plupart des utilitaires commerciaux de nettoyage de messagerie fonctionnent sur la base d'un abonnement. Ils demandent un accès complet au compte et envoient vos e-mails vers leurs propres serveurs pour analyse. L'auteur du projet gmail-cleaner a adopté une approche différente : il a créé un outil local léger avec une interface web qui fonctionne exclusivement sur votre machine via l'API Gmail officielle.

Pourquoi effectuer le nettoyage en local

L'idée principale derrière ce projet est la confidentialité totale. Pas de backends tiers, pas de bases de données externes, pas de plans payants. L'ensemble de la pile fonctionne en local, et vos données ne vont nulle part.

L'application résout quatre problèmes courants :

• Trouve les newsletters et vous aide à vous désabonner en un clic.
• Regroupe les e-mails par expéditeur, montrant qui encombre le plus votre boîte de réception.
• Supprime ou archive en masse des fils de discussion d'expéditeurs sélectionnés.
• Marque des milliers d'e-mails comme lus en quelques secondes.

Tous les e-mails supprimés vont dans la corbeille standard de Gmail. Si vous supprimez accidentellement quelque chose dont vous aviez besoin, vous avez 30 jours pour récupérer les données via l'interface web standard de Google.

Pour accélérer le processus, l'utilitaire utilise les requêtes par lots de l'API Gmail, regroupant jusqu'à 100 opérations en un seul appel. C'est pourquoi le nettoyage de plusieurs milliers d'e-mails prend un temps minimal.

Ce qu'il y a à l'intérieur et comment ça fonctionne

Sous le capot se trouvent Python 3.9+ et un serveur web qui diffuse une interface épurée dans le style de Gmail.

D'un point de vue sécurité, vous créez votre propre application dans Google Cloud Console. Cela signifie que les jetons OAuth vous appartiennent uniquement, et les permissions ne sont demandées que pour le minimum nécessaire : un accès en lecture et modification pour déplacer les messages vers la corbeille et changer le statut de lecture.

Les fichiers credentials.json et token.json sont stockés localement. Dans le build Docker, un volume séparé ./data est prévu à cet effet, vous n'aurez donc pas besoin de réautoriser après le redémarrage du conteneur.

Comment déployer le projet

Le moyen le plus simple d'exécuter le projet est via Docker. Pour les amateurs d'environnements virtuels, il y a aussi une option utilisant le gestionnaire de paquets uv.

Tout d'abord, vous devez vous rendre dans Google Cloud Console, créer un projet, activer l'API Gmail et générer un ID client OAuth (type application Web pour Docker ou application Bureau pour l'exécution Python directe). Assurez-vous d'ajouter votre e-mail à la liste des utilisateurs de test sur l'écran de consentement OAuth.

Enregistrez le fichier téléchargé sous le nom credentials.json à la racine du projet.

Exécution via Docker

Clonez le dépôt :

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

Placez le fichier credentials.json à côté et lancez le conteneur :

docker compose pull && docker compose up

Puis ouvrez http://localhost:8766 dans votre navigateur, cliquez sur le bouton Connexion, récupérez le lien d'autorisation Google dans les logs du conteneur et confirmez l'accès.

Exécution via Python et uv

Si vous ne souhaitez pas configurer Docker, vous pouvez exécuter le script directement via uv :

uv sync
uv run python main.py

L'interface sera disponible à la même adresse http://localhost:8766.

Filtres et exportation de données

Au-delà du simple nettoyage, le projet inclut des filtres avancés. Vous pouvez trier les e-mails par taille de pièce jointe, plage de dates ou catégories standard de Gmail (Promotions, Réseaux sociaux, Mises à jour, Forums, Principal).

Si vous avez besoin de conserver les informations sur les expéditeurs et les dates avant de supprimer d'anciens échanges professionnels, l'interface peut exporter les métadonnées en CSV.

Qui trouvera ceci utile

Le projet est idéal pour toute personne dont la boîte de réception a dépassé la barre des 50 000 messages et approche de la limite de stockage gratuit de Google Drive.

Oui, la configuration initiale nécessite 5 à 10 minutes de travail avec Google Cloud Console et la création de clés OAuth. Mais en retour, vous obtenez un outil qui ne lit pas vos e-mails sur des serveurs tiers et ne nécessite pas d'abonnement mensuel pour les fonctionnalités de nettoyage de base.