gws gmail read

Skill

Gmail: Read a message and extract its body or headers.

Files1
  • @skills/gws-gmail-read/SKILL.md

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

bash
gws gmail +read --id <ID>

Flags

FlagRequiredDefaultDescription
--id✓—The Gmail message ID to read
--headers——Include headers (From, To, Subject, Date) in the output
--format—textOutput format (text, json)
--html——Return HTML body instead of plain text
--dry-run——Show the request that would be sent without executing it

Examples

bash
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-gmail-read — Kortix Marketplace | Kortix