Labsco
googleworkspace logo

gws-gmail-read

✓ Official★ 29,425

by googleworkspace · part of googleworkspace/cli

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

🧰 Not standalone. This skill ships with googleworkspace/cli and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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

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

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