Back to Googleworkspace

gmail +read

skills/gws-gmail-read/SKILL.md

0.22.51.1 KB
Original Source

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
--idThe Gmail message ID to read
--headersInclude headers (From, To, Subject, Date) in the output
--formattextOutput format (text, json)
--htmlReturn HTML body instead of plain text
--dry-runShow 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