gws-gmail — All send, read, and manage email commands
1---2name: gws-gmail-read3description: gmail +read4---5# gmail +read67> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, stop and repair the declarative skill deployment.89Read a message and extract its body or headers1011## Usage1213```bash14gws gmail +read --id <ID>15```1617## Flags1819| Flag | Required | Default | Description |20|------|----------|---------|-------------|21| `--id` | ✓ | — | The Gmail message ID to read |22| `--headers` | — | — | Include headers (From, To, Subject, Date) in the output |23| `--format` | — | text | Output format (text, json) |24| `--html` | — | — | Return HTML body instead of plain text |25| `--dry-run` | — | — | Show the request that would be sent without executing it |2627## Examples2829```bash30gws gmail +read --id 18f1a2b3c4d31gws gmail +read --id 18f1a2b3c4d --headers32gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'33```3435## Tips3637- Converts HTML-only messages to plain text automatically.38- Handles multipart/alternative and base64 decoding.3940## See Also4142- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth43- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
Run npx skillmds@latest add wimpysworld/gws-gmail-read in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
gmail +read It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
wimpysworld (@wimpysworld) published this skill. Their other Agent Skills are listed on their SkillMD profile.
wimpysworld