gws-gmail-read
Gmail: Read a message and extract its body or headers.
How do I install this agent skill?
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-readIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a utility for reading Gmail messages using the official googleworkspace gws CLI tool. No malicious code, obfuscation, or unauthorized data access patterns were identified. While handling email content involves processing untrusted data, this is the intended purpose of the skill.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- ZeroLeakspass
1 finding · Score: 86/100
What does this agent skill do?
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/googleworkspace/cli/gws-gmail-read">View gws-gmail-read on skillZs</a>