Agent skill · software engineering · aiskillstore
gws-gmail-read
Gmail: Read a message and extract its body or headers.
Why this skill is useful
Adds specific commands for reading Gmail messages, including handling multipart and HTML formats, which the AI wouldn't reliably generate on its own.
What it needs
Requires gws installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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 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 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 to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/gws-gmail-read