SKILL.md
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
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