Gururagavendra/gmail-cleaner

O que é?

Recursos principais

• 01Cancelar inscrições em newsletters em massa por uma única interface
• 02Excluir e-mails por remetente, incluindo vários remetentes de uma só vez, com acompanhamento do progresso
• 03Filtrar por período, tamanho do e-mail, categoria do Gmail, remetente e marcadores
• 04Marcar como lidos, arquivar, aplicar ou remover marcadores e marcar como importantes em massa
• 05Exportar metadados de e-mail dos remetentes para CSV
• 06Executar localmente com Docker ou Python, usando credenciais sob seu controle

Casos de uso

• Reduzir a bagunça na caixa de entrada cheia de newsletters promocionais
• Apagar anos de e-mails de alguns remetentes que enviam mensagens demais
• Marcar milhares de e-mails antigos não lidos como lidos de uma só vez
• Verificar quais remetentes enviam e-mails com mais frequência antes de decidir de quais cancelar a inscrição

Início rápido

1. 1

   Clone o repositório

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

   Acesse a pasta do projeto

   cd gmail-cleaner
3. 3

   Instale as dependências com uv

   uv sync
4. 4

   Execute o app e abra http://localhost:8766

   uv run python main.py

Antes de usar

• !Para funcionar, você precisa criar suas próprias credenciais do Google Cloud OAuth (credentials.json).
• !A configuração envolve o Google Cloud Console, a configuração de usuários de teste e os URIs de redirecionamento do OAuth, o que pode dar algum trabalho.
• !Para usar um cliente web OAuth remotamente ou com Docker, é necessário ter um nome de domínio, pois endereços IP não são permitidos como URIs de redirecionamento.

Tópicos

Perguntas frequentes

O que é gmail-cleaner?

Ferramenta Python gratuita e self-hosted que roda localmente para cancelar inscrições em newsletters em massa, excluir e-mails por remetente e marcar mensagens do Gmail como lidas. Gmail Cleaner é um app web local para organizar a caixa de entrada do Gmail. Ele permite encontrar newsletters e cancelar a inscrição, verificar quais remetentes enviam e-mails com mais frequência e excluir ou arquivar as mensagens deles em massa. Também permite marcar grandes quantidades de e-mails não lidos como lidos, gerenciar marcadores, marcar mensagens como importantes e exportar metadados de remetentes para CSV.

gmail-cleaner é gratuito? Qual é a licença?

gmail-cleaner é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

gmail-cleaner ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de gmail-cleaner foi em 18 de ago. de 2026.

Para que posso usar gmail-cleaner?

Reduzir a bagunça na caixa de entrada cheia de newsletters promocionais Apagar anos de e-mails de alguns remetentes que enviam mensagens demais Marcar milhares de e-mails antigos não lidos como lidos de uma só vez Verificar quais remetentes enviam e-mails com mais frequência antes de decidir de quais cancelar a inscrição

Como instalar gmail-cleaner?

Clone o repositório: git clone https://github.com/Gururagavendra/gmail-cleaner.git Acesse a pasta do projeto: cd gmail-cleaner Instale as dependências com uv: uv sync Execute o app e abra http://localhost:8766: uv run python main.py

Onde consigo gmail-cleaner?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Gururagavendra/gmail-cleaner