Pulitore Gmail Locale Senza Inviare la Corrispondenza a Server di Terze Parti

A un certo punto, ciascuno di noi apre la propria email e si ritrova con decine di migliaia di messaggi non letti. Sconti da negozi dove abbiamo comprato qualcosa cinque anni fa, digest di servizi, notifiche da tracker di attività. La pulizia manuale nell'interfaccia nativa di Gmail diventa un incubo perché il client web di Google gestisce con riluttanza selezioni superiori a 50-100 messaggi alla volta.

La maggior parte dei servizi commerciali di pulizia email funzionano su base di abbonamento. Richiedono l'accesso completo all'account e inviano le tue email ai propri server per l'analisi. L'autore del progetto gmail-cleaner ha adottato un approccio diverso: ha scritto uno strumento locale leggero con un'interfaccia web che funziona esclusivamente sulla tua macchina tramite l'API Gmail ufficiale.

Perché Eseguire la Pulizia in Locale

L'idea principale dietro il progetto è la privacy completa. Nessun backend di terze parti, nessun database esterno e nessun piano a pagamento. L'intero stack viene eseguito localmente e i tuoi dati non vanno da nessuna parte.

L'applicazione risolve quattro problemi comuni:

• Trova le newsletter e ti aiuta a disiscriverti con un clic.
• Raggruppa le email per mittente, mostrando chi intasa di più la tua casella di posta.
• Elimina o archivia in massa conversazioni da mittenti selezionati.
• Segna come lette migliaia di email in un paio di secondi.

Tutte le email eliminate vengono spostate nel cestino standard di Gmail. Se elimini accidentalmente qualcosa di cui avevi bisogno, hai 30 giorni per recuperare i dati tramite l'interfaccia web standard di Google.

Per velocizzare le operazioni, l'utility utilizza le richieste batch dell'API Gmail, raggruppando fino a 100 operazioni in una singola chiamata. È per questo che la pulizia di diverse migliaia di email richiede un tempo minimo.

Cosa C'è all'Interno e Come Funziona

Sotto il cofano c'è Python 3.9+ e un server web che fornisce un'interfaccia pulita nello stile di Gmail stesso.

Dal punto di vista della sicurezza, crei la tua applicazione in Google Cloud Console. Questo significa che i token OAuth appartengono solo a te e le autorizzazioni vengono richieste solo per il minimo necessario: accesso in lettura e modifica per spostare i messaggi nel cestino e modificare lo stato di lettura.

I file credentials.json e token.json vengono archiviati localmente. Nel build Docker viene fornito un volume separato ./data per questo scopo, quindi non dovrai riautorizzare dopo aver riavviato il container.

Come Distribuire il Progetto

Il modo più semplice per eseguire il progetto è tramite Docker. Per gli appassionati di ambienti virtuali, c'è anche un'opzione che utilizza il gestore di pacchetti uv.

Innanzitutto, devi andare su Google Cloud Console, creare un progetto, abilitare l'API Gmail e generare un OAuth Client ID (tipo Web application per Docker o Desktop app per l'esecuzione diretta di Python). Assicurati di aggiungere la tua email all'elenco degli utenti di test nella schermata di consenso OAuth.

Salva il file scaricato come credentials.json nella directory principale del progetto.

Esecuzione tramite Docker

Clona il repository:

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

Posiziona il file credentials.json accanto ad esso e avvia il container:

docker compose pull && docker compose up

Quindi apri http://localhost:8766 nel tuo browser, fai clic sul pulsante Accedi, recupera il link di autorizzazione Google dai log del container e conferma l'accesso.

Esecuzione tramite Python e uv

Se non vuoi configurare Docker, puoi eseguire lo script direttamente tramite uv:

uv sync
uv run python main.py

L'interfaccia sarà disponibile allo stesso indirizzo http://localhost:8766.

Filtri ed Esportazione dei Dati

Oltre alla semplice pulizia, il progetto include filtri avanzati. Puoi ordinare le email per dimensione degli allegati, intervallo di date o categorie standard di Gmail (Promozioni, Social, Aggiornamenti, Forum, Principale).

Se hai bisogno di preservare le informazioni sui mittenti e sulle date prima di eliminare vecchia corrispondenza di lavoro, l'interfaccia può esportare i metadati in CSV.

A Chi Sarà Utile

Il progetto è ideale per chiunque la cui casella di posta abbia superato la soglia dei 50.000 messaggi e si stia avvicinando al limite di archiviazione gratuito di Google Drive.

Sì, la configurazione iniziale richiede 5-10 minuti di lavoro con Google Cloud Console e la creazione delle chiavi OAuth. Ma in cambio ottieni uno strumento che non legge le tue email su server di terze parti e non richiede un abbonamento mensile per la funzionalità di pulizia di base.