gws-gmail-read
Installation
Summary
Extract message body and headers from Gmail using message IDs.
- Reads individual Gmail messages by ID and returns body content in plain text or HTML format
- Optionally includes message headers (From, To, Subject, Date) in output
- Supports multiple output formats (text, json) and automatically converts HTML-only messages to plain text
- Handles multipart messages and base64 decoding; includes dry-run mode for testing requests
SKILL.md
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) |
Related skills
More from googleworkspace/cli
gws-gmail
Gmail: Send, read, and manage email.
26.2Kgws-docs
Read and write Google Docs.
26.1Kgws-drive
Google Drive: Manage files, folders, and shared drives.
26.0Kgws-sheets
Google Sheets: Read and write spreadsheets.
24.7Kgws-calendar
Google Calendar: Manage calendars and events.
24.7Kgws-docs-write
Google Docs: Append text to a document.
21.8K