Gws Gmail Read
Gmail: Read a message and extract its body or headers.
Install
npx skills add googleworkspace/cli --skill gws-gmail-readgit clone --depth 1 https://github.com/googleworkspace/cli.git /tmp/cli
mkdir -p ~/.claude/skills
cp -r /tmp/cli/skills/gws-gmail-read ~/.claude/skills/gws-gmail-readPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the 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 | 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 ```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-shared](../gws-shared/SKILL.md) — Global flags and auth - [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
Details
- Skill name
gws-gmail-read- Repository
- googleworkspace/cli
- Path
skills/gws-gmail-read/SKILL.md- License
- Apache-2.0
- Repo updated
- 3 November 2026
FAQ
What does the Gws Gmail Read skill do?
Gmail: Read a message and extract its body or headers.
How do I install the Gws Gmail Read skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add googleworkspace/cli --skill gws-gmail-read. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Gws Gmail Read popular?
It lives in googleworkspace/cli, which has 32,385 GitHub stars and 1,999 forks, and is included in 2 curated skill lists.
Related skills
Gws Admin Reports
32kgoogleworkspace/cli
Google Workspace Admin SDK: Audit logs and usage reports.
Gws Classroom
32kgoogleworkspace/cli
Google Classroom: Manage classes, rosters, and coursework.
Gws Drive
32kgoogleworkspace/cli
Google Drive: Manage files, folders, and shared drives.
Gws Gmail Reply
32kgoogleworkspace/cli
Gmail: Reply to a message (handles threading automatically).
Gws Calendar Agenda
32kgoogleworkspace/cli
Google Calendar: Show upcoming events across all calendars.
Gws Gmail Reply All
32kgoogleworkspace/cli
Gmail: Reply-all to a message (handles threading automatically).
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.