gmailcleaner

Reads emails from Gmail (all folders/labels) using the gog CLI. Use when the user asks to check email, read inbox, show unread messages, list folders, search...

Email Reader

Lee correos de Gmail usando el CLI gog. Requiere que gog auth esté configurado. Si no lo está, ejecuta el setup primero.

Setup inicial (solo una vez)

gog auth credentials /ruta/a/client_secret.json
gog auth add $GOG_ACCOUNT --services gmail
gog auth list   # verificar que quedó bien

Cuándo usar esta skill

• "Revisa mi correo"
• "¿Qué correos nuevos tengo?"
• "Muéstrame los no leídos de hoy"
• "Lee los correos de Juan"
• "Busca correos sobre la propuesta del Q1"
• "¿Cuántos correos de spam tengo?"
• "Muéstrame el hilo de [asunto]"
• "Lee la carpeta Clientes"

Comandos principales

Leer inbox (correos recientes)

gog gmail search 'in:inbox newer_than:1d' --max 20 --json
gog gmail search 'in:inbox is:unread' --max 50 --json
gog gmail search 'in:inbox newer_than:7d' --max 100 --json

Leer spam

gog gmail search 'in:spam newer_than:30d' --max 50 --json

Leer una carpeta/etiqueta específica

# Etiquetas de sistema
gog gmail search 'in:sent newer_than:7d' --max 20 --json
gog gmail search 'in:drafts' --max 20 --json
gog gmail search 'in:trash newer_than:30d' --max 20 --json
gog gmail search 'is:starred' --max 20 --json

# Etiquetas personalizadas (carpetas del usuario)
gog gmail search 'label:Clientes newer_than:30d' --max 20 --json
gog gmail search 'label:Proyectos' --max 20 --json
gog gmail search 'label:Facturas newer_than:90d' --max 20 --json

Buscar correos

# Por remitente
gog gmail search 'from:[e-mail] newer_than:30d' --max 20 --json

# Por asunto
gog gmail search 'subject:propuesta' --max 10 --json

# Por contenido
gog gmail search 'propuesta presupuesto 2026' --max 10 --json

# Combinado
gog gmail search 'from:[e-mail] is:unread newer_than:7d' --max 10 --json

# Con adjuntos
gog gmail search 'has:attachment in:inbox newer_than:7d' --max 10 --json

Filtros de tiempo útiles

Filtro	Significado
newer_than:1d	último día
newer_than:7d	última semana
newer_than:30d	último mes
older_than:180d	más de 6 meses
after:2026/01/01	desde fecha exacta

Presentación de resultados

Después de obtener el JSON, presenta un resumen claro al usuario:

📥 INBOX — 8 correos nuevos (3 no leídos)

  ⭐ [hoy 09:14] [e-mail]
     "Reunión urgente esta tarde"

  📧 [hoy 08:30] [e-mail]
     "Re: Propuesta Q1 2026"

  📰 [ayer 18:00] [e-mail]
     "Top 10 AI tools this week"
  ...

¿Quieres que analice estos correos o que responda alguno?

Múltiples cuentas

Si el usuario tiene más de una cuenta de Gmail:

# Listar cuentas configuradas
gog auth list

# Leer de una cuenta específica
gog gmail search 'in:inbox is:unread' --account [e-mail] --max 20 --json

# Cambiar cuenta por defecto
export GOG_ACCOUNT=[e-mail]

Notas importantes

• Usar siempre --json para obtener datos estructurados
• Usar --no-input en modo automático/cron para evitar prompts interactivos
• El flag --max limita resultados; aumentar si el usuario quiere más
• Los resultados de búsqueda de Gmail usan la misma sintaxis que gmail.com