Gws Gmail Read

Reads a Gmail message by ID and extracts its body or headers, with options for JSON output and HTML body.

vikingokft Updated 0 repo stars

File contents

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

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

vikingokft/vikingo-studio-skills commit dc153af447

Frequently asked questions

npx get-skill add vikingokft/gws-gmail-read