Cli gws-gmail-read

Name: gws-gmail-read
Author: googleworkspace

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

install

source · Clone the upstream repo

git clone https://github.com/googleworkspace/cli

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/googleworkspace/cli "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/gws-gmail-read" ~/.claude/skills/googleworkspace-cli-gws-gmail-read && rm -rf "$T"

manifest: 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

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.