Gws Gmail Read
Gmail: Read a message and extract its body or headers.
Specification
- Skill ID
- googleworkspace/cli/gws-gmail-read
- Publisher
- googleworkspace
- Repository
- cli
- Installs
- 0
- Files
- 1
- Synced
- Sep 16, 2026
How to use it
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
googleworkspace/cli/gws-gmail-readInstalls these files- SKILL.md
What this skill tells the agent
gmail +read
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Read a message and extract its body or headers
Usage
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
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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
More from googleworkspace
Use this skill in a project
Open any RiverX project, search the Skills panel for googleworkspace/cli/gws-gmail-read, and install it in one click.