Communitygithub.com

Gestión de Bandeja de Entrada de Gmail

Gestiona correos electrónicos en múltiples cuentas de Gmail con herramientas unificadas. Útil cuando el usuario pide revisar correo, leer la bandeja de entrada, etiquetar correos, archivar mensajes o administrar Gmail entre cuentas.

¿Qué es Gestión de Bandeja de Entrada de Gmail?

Esta habilidad permite a un agente de IA gestionar correos electrónicos a través de múltiples cuentas de Gmail de manera unificada. Es útil para usuarios que necesitan revisar su bandeja de entrada, etiquetar, archivar o marcar como leídos correos en varias cuentas de Gmail sin cambiar de contexto. Los scripts proporcionados automatizan tareas como listar mensajes no leídos, aplicar etiquetas, archivar y crear filtros, todo a través de la línea de comandos. Soporta autenticación por separado para cada cuenta y ofrece opciones como simulación de ejecución para previsualizar cambios antes de aplicarlos. La habilidad es gratuita y se integra con las APIs de Gmail, Google Sheets y Google Drive.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiagentwithdhruv/skills/tree/HEAD/gmail-inbox

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Gestión de Bandeja de Entrada de Gmail?

Objetivo

Revisar y gestionar correos electrónicos en múltiples cuentas de Gmail usando herramientas unificadas.

Scripts

  • ./scripts/gmail_unified.py - Revisar y gestionar bandejas de entrada
  • ./scripts/gmail_multi_auth.py - Autenticar cuentas
  • ./scripts/gmail_bulk_label.py - Etiquetado masivo
  • ./scripts/gmail_create_filters.py - Crear filtros
  • ./scripts/gmail_auth.py - Ayudante de autenticación

Referencia Rápida

# Revisar no leídos en todas las cuentas
python3 ./scripts/gmail_unified.py --query "is:unread" --limit 50

# Revisar solo cuenta específica
python3 ./scripts/gmail_unified.py --query "is:unread" --account tuempresa

# Listar cuentas registradas
python3 ./scripts/gmail_unified.py --accounts

# Etiquetar y archivar correos
python3 ./scripts/gmail_unified.py --query "from:notifications@" --label "Notificaciones" --archive

# Marcar como leído
python3 ./scripts/gmail_unified.py --query "from:noreply@" --mark-read

# Simulación (vista previa)
python3 ./scripts/gmail_unified.py --query "subject:factura" --label "Facturas" --dry-run

Registro de Cuentas

CuentaCorreoCredencialesToken
tuusuario[email protected]credentials.jsontoken_tuusuario.json
tuempresa[email protected]credentials_tuempresa.jsontoken_tuempresa.json

Solución de Problemas de Autenticación

"No se encontró el archivo de token"

python3 ./scripts/gmail_multi_auth.py --account tuempresa --email [email protected]

"invalid_scope: Bad Request"

rm token_tuusuario.json
python3 ./scripts/gmail_multi_auth.py --account tuusuario --email [email protected]

"Error de autenticación" Verifica que el archivo credentials.json exista en el directorio raíz.

Ámbitos Requeridos

  • gmail.modify - Leer/escribir correos
  • gmail.labels - Crear/gestionar etiquetas
  • gmail.settings.basic - Gestionar ajustes
  • spreadsheets - Acceso a Google Sheets
  • drive - Acceso a Google Drive

Ubicación de Credenciales

Todos los archivos de credenciales deben estar en la raíz del espacio de trabajo:

  • credentials.json / credentials_tuempresa.json - Configuraciones de cliente OAuth
  • token_*.json - Tokens de autenticación (generados automáticamente)
  • gmail_accounts.json - Registro de cuentas

Esquema

Entradas

NombreTipoRequeridoDescripción
querystringNoConsulta de búsqueda de Gmail (ej. 'is:unread')
accountstringNoNombre específico de cuenta del registro
limitintegerNoMáximo de correos a obtener (predeterminado: 50)

Salidas

NombreTipoDescripción
emailsarrayLista de objetos de correo con asunto, de, fecha, fragmento

Credenciales

NombreFuente
credentials.jsonarchivo
token_*.jsonarchivo (generado automáticamente)

Componible con

Habilidades que se combinan bien con esta: gmail-label, instantly-autoreply

Costo

Gratuito (API de Gmail)

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

aiagentwithdhruv/skills

Add new Modal webhooks for event-driven execution. Use when user asks to create a webhook, add an endpoint, or set up event triggers.

aiagentwithdhruv/skills

Answer Euron Gen AI Bootcamp doubts instantly. Covers Euri API setup across all frameworks (Python, LangChain, OpenAI SDK, TypeScript, n8n, curl), MCP server setup, common errors, model recommendations, and token limits. Use when someone in the bootcamp asks a question.

aiagentwithdhruv/skills

Auto-label Gmail emails into Action Required, Waiting On, and Reference categories. Use when user asks to label emails, triage inbox, categorize emails, or organize Gmail.

aiagentwithdhruv/skills

Scrape Google Maps for B2B leads with deep website enrichment and contact extraction. Use when user asks to find local businesses, scrape Google Maps, generate contractor lists, or build local service business databases.

aiagentwithdhruv/skills

Run Claude orchestrator locally with Cloudflare tunneling. Use when user asks to run locally, start local server, or test webhooks locally.

aiagentwithdhruv/skills

MCP server for AI-powered macOS control — apps, display, audio, files, screenshots, clipboard

aiagentwithdhruv/skills

Deploy execution scripts to Modal cloud. Use when user asks to deploy to Modal, push code to cloud, or update Modal functions.

aiagentwithdhruv/skills

Scrape and verify business leads using Apify, classify with LLM, enrich emails, and save to Google Sheets. Use when user asks to find leads, scrape businesses, generate prospect lists, or build lead databases for any industry or location.

aiagentwithdhruv/skills

Query Skool community content using RAG pipeline with vector search. Use when user asks to search Skool knowledge, find community answers, or query Skool content.

aiagentwithdhruv/skills

Scrape Upwork jobs and generate personalized proposals with cover letters. Use when user asks to find Upwork jobs, create Upwork proposals, or apply to Upwork listings.

Skills relacionados