# Gws Gmail Read

> Gmail: lee un mensaje y extrae su cuerpo o sus headers.

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

Repositorio: https://github.com/googleworkspace/cli
Autor: googleworkspace
Licencia: Apache-2.0
Actualizado: hace 6 meses
Coste de contexto: 14 tok instalada, 350 tok al activarse, 350 tok con todos los archivos del bundle
Bundle: 1 archivo, 1 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-read --agent claude-code
# Cursor
npx -y skills add googleworkspace/cli --skill gws-gmail-read --agent cursor
# Codex
npx -y skills add googleworkspace/cli --skill gws-gmail-read --agent codex
# Gemini CLI
npx -y skills add googleworkspace/cli --skill gws-gmail-read --agent gemini
# Windsurf
npx -y skills add googleworkspace/cli --skill gws-gmail-read --agent windsurf
# Cline
npx -y skills add googleworkspace/cli --skill gws-gmail-read --agent cline
```

## Qué hace

- Lee un mensaje de Gmail por su ID y extrae el cuerpo o los headers
- Convierte mensajes solo-HTML a texto plano automáticamente
- Decodifica multipart/alternative y base64
- Permite ver headers (From, To, Subject, Date) con --headers

## Cuándo usarla

- Necesitas leer el contenido de un mensaje específico de Gmail conociendo su ID
- Quieres extraer solo el body o solo los headers de un correo
- Quieres el resultado en JSON para procesarlo con jq

## Qué la activa

- "Lee el mensaje de Gmail con ID 18f1a2b3c4d"
- "Muéstrame los headers del correo 18f1a2b3c4d"
- "Extrae el body en JSON del mensaje 18f1a2b3c4d con gws gmail +read"

## Antes de instalar

- Requiere el binario gws y haber configurado auth/flags globales según gws-shared/SKILL.md.
- Necesita en el PATH: jq

## Archivos

- SKILL.md — 1 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 +read

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

Read a message and extract its body or headers

## Usage

```bash
gws gmail +read --id <ID>
```

## Flags

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--id` | ✓ | — | The Gmail message ID to read |
| `--headers` | — | — | Include headers (From, To, Subject, Date) in the output |
| `--format` | — | text | Output format (text, json) |
| `--html` | — | — | Return HTML body instead of plain text |
| `--dry-run` | — | — | Show the request that would be sent without executing it |

## Examples

```bash
gws gmail +read --id 18f1a2b3c4d
gws gmail +read --id 18f1a2b3c4d --headers
gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'
```

## Tips

- Converts HTML-only messages to plain text automatically.
- Handles multipart/alternative and base64 decoding.

## 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

- [Gws Admin Reports](https://skillsagentes.com/skills/googleworkspace/cli/gws-admin-reports.md): Google Workspace Admin SDK: logs de auditoría y reportes de uso.
- [Gws Calendar](https://skillsagentes.com/skills/googleworkspace/cli/gws-calendar.md): Google Calendar: gestiona calendarios y eventos.
- [Gws Calendar Agenda](https://skillsagentes.com/skills/googleworkspace/cli/gws-calendar-agenda.md): Google Calendar: muestra los próximos eventos de todos los calendarios.
- [Gws Calendar Insert](https://skillsagentes.com/skills/googleworkspace/cli/gws-calendar-insert.md): Google Calendar: crea un nuevo evento.
- [Gws Chat](https://skillsagentes.com/skills/googleworkspace/cli/gws-chat.md): Google Chat: gestiona espacios y mensajes de Chat.

## Skills relacionadas

- [Gws Admin Reports](https://skillsagentes.com/skills/googleworkspace/cli/gws-admin-reports.md): Google Workspace Admin SDK: logs de auditoría y reportes de uso.
- [Gws Calendar](https://skillsagentes.com/skills/googleworkspace/cli/gws-calendar.md): Google Calendar: gestiona calendarios y eventos.
- [Gws Calendar Agenda](https://skillsagentes.com/skills/googleworkspace/cli/gws-calendar-agenda.md): Google Calendar: muestra los próximos eventos de todos los calendarios.
- [Gws Calendar Insert](https://skillsagentes.com/skills/googleworkspace/cli/gws-calendar-insert.md): Google Calendar: crea un nuevo evento.
- [Gws Chat](https://skillsagentes.com/skills/googleworkspace/cli/gws-chat.md): Google Chat: gestiona espacios y mensajes de Chat.

---

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