# Gws Gmail Watch

> Gmail: vigila la llegada de correos nuevos y transmítelos como NDJSON.

Fuente: https://skillsagentes.com/skills/googleworkspace/cli/gws-gmail-watch
Markdown: https://skillsagentes.com/skills/googleworkspace/cli/gws-gmail-watch.md

Repositorio: https://github.com/googleworkspace/cli
Autor: googleworkspace
Licencia: Apache-2.0
Actualizado: hace 6 meses
Coste de contexto: 14 tok instalada, 486 tok al activarse, 486 tok con todos los archivos del bundle
Bundle: 1 archivo, 2 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add googleworkspace/cli --skill gws-gmail-watch --agent claude-code
# Cursor
npx -y skills add googleworkspace/cli --skill gws-gmail-watch --agent cursor
# Codex
npx -y skills add googleworkspace/cli --skill gws-gmail-watch --agent codex
# Gemini CLI
npx -y skills add googleworkspace/cli --skill gws-gmail-watch --agent gemini
# Windsurf
npx -y skills add googleworkspace/cli --skill gws-gmail-watch --agent windsurf
# Cline
npx -y skills add googleworkspace/cli --skill gws-gmail-watch --agent cline
```

## Qué hace

- Ejecuta `gws gmail +watch` para monitorizar Gmail y transmitir nuevos correos como NDJSON
- Configura recursos de Pub/Sub en GCP (proyecto, topic, suscripción) o reutiliza los existentes
- Filtra por etiquetas de Gmail, controla el tamaño de lote y el intervalo de sondeo
- Permite escribir cada mensaje en un archivo JSON separado con --output-dir
- Limpia los recursos de Pub/Sub creados al salir con --cleanup

## Cuándo usarla

- Necesitas recibir y procesar correos de Gmail nuevos en tiempo real como stream NDJSON
- Quieres integrar notificaciones push de Gmail vía Pub/Sub sin configurar todo manualmente

## Qué la activa

- "Vigila mi bandeja de Gmail y muéstrame los correos nuevos en NDJSON"
- "Configura un watch de Gmail con mi proyecto de GCP y limpia los recursos al terminar"
- "Haz un pull único de los correos con la etiqueta INBOX"

## Antes de instalar

- Requiere el binario `gws` y haber leído ../gws-shared/SKILL.md para autenticación, flags globales y reglas de seguridad.

## Archivos

- SKILL.md — 2 KB

## SKILL.md

Reproducido tal cual desde googleworkspace/cli bajo Apache-2.0. Esta sección es el documento original y está en inglés.

# gmail +watch

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

Watch for new emails and stream them as NDJSON

## Usage

```bash
gws gmail +watch
```

## Flags

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--project` | — | — | GCP project ID for Pub/Sub resources |
| `--subscription` | — | — | Existing Pub/Sub subscription name (skip setup) |
| `--topic` | — | — | Existing Pub/Sub topic with Gmail push permission already granted |
| `--label-ids` | — | — | Comma-separated Gmail label IDs to filter (e.g., INBOX,UNREAD) |
| `--max-messages` | — | 10 | Max messages per pull batch |
| `--poll-interval` | — | 5 | Seconds between pulls |
| `--msg-format` | — | full | Gmail message format: full, metadata, minimal, raw |
| `--once` | — | — | Pull once and exit |
| `--cleanup` | — | — | Delete created Pub/Sub resources on exit |
| `--output-dir` | — | — | Write each message to a separate JSON file in this directory |

## Examples

```bash
gws gmail +watch --project my-gcp-project
gws gmail +watch --project my-project --label-ids INBOX --once
gws gmail +watch --subscription projects/p/subscriptions/my-sub
gws gmail +watch --project my-project --cleanup --output-dir ./emails
```

## Tips

- Gmail watch expires after 7 days — re-run to renew.
- Without --cleanup, Pub/Sub resources persist for reconnection.
- Press Ctrl-C to stop gracefully.

## See Also

- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands

## Dónde encaja

- Categoría: [Productividad](https://skillsagentes.com/categorias/productividad.md) — Planificación, toma de notas y automatización de flujos personales.
- Creador: [googleworkspace](https://skillsagentes.com/creators/googleworkspace.md) — 95 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Persona Customer Support](https://skillsagentes.com/skills/googleworkspace/cli/persona-customer-support.md): Gestiona el soporte al cliente: seguimiento de tickets, respuestas y escalado de problemas.
- [Gws People](https://skillsagentes.com/skills/googleworkspace/cli/gws-people.md): Google People: gestiona contactos y perfiles.
- [Recipe Bulk Download Folder](https://skillsagentes.com/skills/googleworkspace/cli/recipe-bulk-download-folder.md): Lista y descarga todos los archivos de una carpeta de Google Drive.
- [Recipe Create Events From Sheet](https://skillsagentes.com/skills/googleworkspace/cli/recipe-create-events-from-sheet.md): Lee datos de eventos desde una hoja de Google Sheets y crea las correspondientes entradas en Google Calendar para cada fila.
- [Recipe Forward Labeled Emails](https://skillsagentes.com/skills/googleworkspace/cli/recipe-forward-labeled-emails.md): Busca mensajes de Gmail con una etiqueta específica y los reenvía a otra dirección de correo.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)