boazcstrike/gws-gmail-read
skills/gws-gmail-read/SKILL.md
Gmail: Read a message and extract its body or headers.
$ install --global
skillsauthnpx skillsauth add boazcstrike/opencode gws-gmail-readInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 10:26 PM2.9s1 file scanned
SKILL.md
- name:
- gws-gmail-read
- version:
- 1.0.0
- description:
- Gmail: Read a message and extract its body or headers.
- category:
- productivity
- bins:
- ["gws"]
- cliHelp:
- gws gmail +read --help
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
Related Skills
boazcstrike/gws-workflow-file-announce
development
VerifiedTrustedCommunity
Google Workflow: Announce a Drive file in a Chat space.
2SKILL.mdUpdated Apr 20, 2026
boazcstrike/gws-workflow-email-to-task
development
VerifiedTrustedCommunity
Google Workflow: Convert a Gmail message into a Google Tasks entry.
2SKILL.mdUpdated Apr 20, 2026
boazcstrike/gws-tasks
development
VerifiedTrustedCommunity
Google Tasks: Manage task lists and tasks.
2SKILL.mdUpdated Apr 20, 2026
boazcstrike/gws-slides
development
VerifiedTrustedCommunity
Google Slides: Read and write presentations.
2SKILL.mdUpdated Apr 20, 2026