gmail-cleaner
Herramienta open source para limpieza masiva de Gmail: desuscripción en bloque, eliminación por remitente y marcado como leído. Ejecución local con enfoque estricto en privacidad.
Ficha actualizada 10 nov 2026, 0:03 · upstream 22 oct 2026, 6:29 · release v1.3.0
Qué es gmail-cleaner
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Gmail Cleaner es una aplicación de código abierto diseñada para gestionar el volumen de correo electrónico personal sin comprometer la privacidad. La herramienta permite realizar operaciones masivas directamente desde tu máquina, eliminando suscripciones a newsletters no deseadas, borrando correos por remitente y marcando miles de mensajes como leídos en segundos.
El proyecto utiliza Python con FastAPI como backend y ofrece una interfaz web limpia que replica la experiencia de Gmail. Soporta despliegue nativo en Docker y ejecución local mediante pip o uv. La arquitectura prioriza el control total del usuario sobre sus credenciales, requiriendo la creación personalizada de aplicaciones OAuth en Google Cloud para cada instalación.
La aplicación incluye funcionalidades avanzadas como gestión de etiquetas, marcado de mensajes importantes, descarga de metadatos en CSV y filtros inteligentes por categoría (Promociones, Sociales, Actualizaciones). Todo el procesamiento se realiza localmente sin envío de datos a servidores externos.
- Limpieza masiva de bandeja de entrada eliminando correos no deseados por remitente
- Desuscripción automática de newsletters y boletines detectados en la bandeja
- Gestión eficiente de etiquetas para organizar el flujo de correo electrónico
- Marcado en bloque de miles de mensajes como leídos o importantes
- Exportación de metadatos de correos específicos en formato CSV para análisis
- Ejecución 100% local sin envío de datos a servidores externos ni recopilación de información
- Soporte nativo para Docker con persistencia automática de tokens de autenticación
- Interfaz web familiar que replica la experiencia de Gmail con seguimiento en tiempo real
- Código abierto bajo licencia MIT permitiendo auditoría completa de la seguridad
- Optimizado con solicitudes por lotes de 100 correos mediante la API de Gmail
- Soporte multiplataforma para Linux, Windows y macOS incluyendo Apple Silicon
- Requiere configuración manual de credenciales OAuth en Google Cloud Console
- Necesita crear una aplicación propia en Google Auth Platform con dominio válido
- No incluye autenticación preconfigurada para mantener el enfoque en privacidad
- Los archivos de datos persisten en directorio ./data que debe gestionarse manualmente
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Pendiente de la cola editorial R11-R6 con investigación verificable.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.