Gururagavendra/gmail-cleaner

¿Qué es?

Funciones clave

• 01Cancelar suscripciones a newsletters en bloque desde una sola interfaz
• 02Borrar correos por remitente, incluso de varios remitentes a la vez, con seguimiento del progreso
• 03Filtrar por intervalo de fechas, tamaño del correo, categoría de Gmail, remitente y etiquetas
• 04Marcar como leídos, archivar, aplicar o quitar etiquetas y marcar como importantes en bloque
• 05Exportar metadatos de los correos de los remitentes a CSV
• 06Se ejecuta localmente con Docker o Python y credenciales bajo tu control

Casos de uso

• Reducir el desorden de una bandeja de entrada llena de newsletters promocionales
• Eliminar años de correos de unos pocos remitentes que envían demasiados mensajes
• Marcar como leídos miles de correos antiguos sin leer de una sola vez
• Revisar qué remitentes te escriben más antes de decidir de cuáles cancelar la suscripción

Inicio rápido

1. 1

   Clona el repositorio

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

   Ve a la carpeta del proyecto

   cd gmail-cleaner
3. 3

   Instala las dependencias con uv

   uv sync
4. 4

   Ejecuta la aplicación y abre http://localhost:8766

   uv run python main.py

Antes de usarlo

• !Antes de que funcione, debes crear tus propias credenciales de Google Cloud OAuth (credentials.json).
• !La configuración requiere usar Google Cloud Console, configurar usuarios de prueba y definir URI de redirección de OAuth, lo que puede resultar algo engorroso.
• !Para usar un cliente web de OAuth en remoto o con Docker, necesitas un nombre de dominio, ya que no se permiten direcciones IP como URI de redirección.

Temas

Preguntas frecuentes

¿Qué es gmail-cleaner?

Herramienta gratuita de Python, autoalojada y de ejecución local, para cancelar suscripciones a newsletters en bloque, borrar correos por remitente y marcar correos de Gmail como leídos. Gmail Cleaner es una aplicación web local para poner en orden la bandeja de entrada de Gmail. Permite encontrar newsletters y cancelar la suscripción, consultar qué remitentes te escriben con más frecuencia y borrar o archivar sus mensajes en bloque. También permite marcar como leídos muchos correos sin leer, administrar etiquetas, marcar mensajes como importantes y exportar metadatos de los remitentes a CSV.

¿gmail-cleaner es gratuito? ¿Qué licencia tiene?

gmail-cleaner es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿gmail-cleaner sigue mantenido?

Actualizado en los últimos 6 meses. El último commit de gmail-cleaner fue el 18 ago 2026.

¿Para qué puedo usar gmail-cleaner?

Reducir el desorden de una bandeja de entrada llena de newsletters promocionales Eliminar años de correos de unos pocos remitentes que envían demasiados mensajes Marcar como leídos miles de correos antiguos sin leer de una sola vez Revisar qué remitentes te escriben más antes de decidir de cuáles cancelar la suscripción

¿Cómo se instala gmail-cleaner?

Clona el repositorio: git clone https://github.com/Gururagavendra/gmail-cleaner.git Ve a la carpeta del proyecto: cd gmail-cleaner Instala las dependencias con uv: uv sync Ejecuta la aplicación y abre http://localhost:8766: uv run python main.py

¿Dónde consigo gmail-cleaner?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Gururagavendra/gmail-cleaner