Usa la skill
Dásela a Claude Code, Cursor, OpenCode u otro agente con acceso a shell. Lee solo cabeceras, muestra el plan primero y te da el comando de undo.
Abrir la skillO y pégalo en Claude Code, Cursor u OpenCode.
Código abierto · Skill para agentes · App local
Limpia tu bandeja.
Deshaz cada movimiento.
CleanYourMail es una skill open source para agentes, con una app local opcional, para limpiar buzones IMAP. Lee solo cabeceras, te muestra un plan antes de cambiar nada, protege el correo importante y te da el comando de undo. Las bajas son independientes e irreversibles.
Gratis · MIT · Sin cuenta · Sin telemetría · Sin borrado permanente
SKILL PARA AGENTESProducto principal
Dásela a tu agente.
Lee SKILL.md de
https://github.com/jparedesDS/cleanyourmail
y síguelo exactamente.
Usa python tools/mail.py.
Solo cabeceras. Nunca borres de forma permanente.
Muéstrame el plan antes de cambiar nada.
Mueve primero, verifica y luego da de baja por separado.
Dame el comando de undo.Pégalo en Claude Code, Cursor, OpenCode o cualquier agente con acceso a shell.
Skill primero · app opcional · CLI en GitHub
Elige tu camino
Usa la skill o la app.
La skill es el producto principal: dásela a tu agente y revisa el plan. La app es el camino simple para quien prefiere botones. La CLI sigue en GitHub para usuarios avanzados.
App · MVP inicial
Descargar la app
Una app local y segura para quien prefiere botones a comandos. Escanea cabeceras, revisa el plan, aplica movimientos reversibles y deshaz desde una pantalla. Sin cuenta ni telemetría; el feedback es opcional.
Descargar para WindowsWindows 10/11 · instalador · MVP temprano
¿Prefieres la terminal? La CLI sigue en GitHub.
Cómo funciona
Nada cambia hasta que apruebes un plan.
-
01
Conecta en local
Abre la skill en tu agente o usa la app. Elige tu proveedor e introduce tu credencial. Comprueba la conexión antes de nada.
-
02
Escanea y revisa
La skill o la app lee solo metadatos de cabeceras: remitente, asunto, fecha, tamaño y flags. Muestra categorías, correo protegido, destinos y bajas. Nada cambia todavía.
-
03
Mueve un lote pequeño
Aplica unos pocos movimientos. El journal registra la ejecución y Deshacer la restaura. Revisa el resultado antes de gestionar las bajas por separado.
Proveedores
Funciona con tu proveedor.
Sin migrar tu buzón. Necesitas acceso IMAP y el método de autenticación que permita tu proveedor.
GmailContraseña de aplicación + 2FA
Outlook / Microsoft 365Microsoft 365: consentimiento de admin
YahooContraseña de aplicación
iCloudContraseña específica
FastmailContraseña de aplicación + Sieve
ProtonProton Bridge
Cualquier servidor IMAP con UIDPLUS o MOVE y Trash, Junk y Archive resolubles funciona. Notas de proveedores · estado de validación.
Los nombres y logos de los proveedores son marcas de sus respectivos propietarios.
Seguridad
Primero revisa. Deshaz los movimientos.
Sin borrado permanente
No existe un comando de borrado permanente. CleanYourMail nunca vacía Trash ni Junk y nunca ejecuta un expunge general del buzón.
Solo cabeceras
Lee remitente, asunto, fecha, tamaño, flags y cabeceras de baja, y guarda esos metadatos en tu equipo. Nunca descarga cuerpos ni adjuntos.
El correo protegido se queda
El correo personal, transaccional, de seguridad, bancario, facturas, viajes, salud, gobierno, legal, destacado, respondido y reciente queda excluido de movimientos y bajas automáticas.
Revisa, mueve y deshaz
scan, report y plan no cambian nada. Revisa el plan, empieza con un movimiento pequeño y usa el journal y undo para restaurar esa ejecución. La baja es independiente e irreversible.
Se ejecuta en local: sin servicio CleanYourMail alojado, sin cuenta, sin telemetría. Inspecciona el código, el modelo de seguridad y las pruebas.
FAQ
Preguntas antes de conectar.
¿Borra correo?
No. No tiene un comando de borrado permanente, nunca vacía Trash ni Junk y nunca ejecuta un expunge general del buzón. Los movimientos y el archivado quedan registrados; las solicitudes de baja no son reversibles.
¿Qué lee?
Solo cabeceras: remitente, asunto, fecha, tamaño, flags y cabeceras de baja. Nunca descarga cuerpos ni adjuntos. La caché local guarda metadatos, no cuerpos de mensaje.
¿Necesito conocimientos técnicos?
La app es el camino simple. La skill, el producto principal, necesita un agente con acceso a shell. La CLI es para quien prefiere la terminal. Las tres usan el mismo plan y el mismo modelo de undo.
¿Funciona con mi proveedor?
Gmail, Outlook/Microsoft 365, Yahoo, iCloud, Fastmail, Proton Bridge y servidores IMAP personalizados compatibles. Gmail necesita una contraseña de aplicación con verificación en dos pasos; el inicio de sesión de Microsoft 365 requiere consentimiento del admin del tenant; Outlook.com personal requiere verified publisher (pendiente); Proton necesita Bridge. Los movimientos por IMAP personalizado requieren UIDPLUS o MOVE. Las políticas del proveedor o de la organización pueden bloquear el acceso; la herramienta no las elude.
¿Qué pasa si algo sale mal?
Detente y revisa el error. La skill, la CLI y la app vuelven a comprobar el plan antes de aplicarlo y registran cada ejecución. Usa el comando undo indicado para restaurar los movimientos de esa ejecución. Si un mensaje ya no puede localizarse, el journal sigue disponible para una recuperación manual. Las solicitudes de baja no se pueden deshacer.
¿Es realmente gratis?
Sí. Licencia MIT, sin plan de pago, sin cuenta de CleanYourMail y sin telemetría. Tú aportas tu equipo, tu instalación de Python y el acceso de tu proveedor.
Comentarios
Cuéntanos qué corregir.
¿Encontraste un error o tienes una idea? Envíala al Discord de CleanYourMail. Nada se envía automáticamente: escribe los detalles, acepta la línea de consentimiento y pulsa Enviar. Quita todo lo que no quieras enviar y no incluyas contraseñas, tokens ni el contenido completo de un mensaje.
Empieza con un plan.
No cambies nada hasta decir que sí.
Gratuito y de código abierto. Sin cuenta, sin telemetría y sin borrado permanente.