gws-gmail-read
"Gmail: Read a message and extract its body or headers."
Install
npx skillscat add googleworkspace/cli/gws-gmail-read Install via the SkillsCat registry.
About this skill
The gws-gmail-read skill reads a Gmail message identified by its ID and extracts either its body text or header fields. It solves the need to programmatically retrieve email content without manual access. Agents or developers should use it when they need to fetch message data for processing, analysis, or integration.
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) |
--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
Categories
Install
npx skillscat add googleworkspace/cli/gws-gmail-read Install via the SkillsCat registry.