gws-gmail-read
Gmail: Read a message and extract its body or headers.
pinned to #a3768d0updated 2 weeks ago
Ask your AI client: “install skills/gws-gmail-read”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/gws-gmail-readmetahub onboarded this repo on the author's behalf.
If you own github.com/googleworkspace/cli on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
29,590
Last commit
2 weeks ago
Latest release
published
- #agent-skills
- #ai-agent
- #automation
- #cli
- #discovery-api
- #gemini-cli-extension
- #google-admin
- #google-api
- #google-calendar
- #google-chat
- #google-docs
- #google-drive
- #google-sheets
- #google-workspace
- #oauth2
- #rust
About this skill
Pulled from SKILL.md at publish time.
> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.a3768d0· 2 weeks ago
Documentation
41Description qualitywarn
10 words · 54 chars — skills use the description as their trigger; aim higher
Aim for 15+ words and include trigger phrases like “use this skill when …”.
README is present and substantial
20,235 chars · 16 sections · 22 code blocks
Tags / topics declared
16 total — agent-skills, ai-agent, automation, cli, discovery-api, gemini-cli-extension (+10)
README has usage / example sections
found: Installation · Quick Start
Homepage / docs URL declared
https://developers.google.com/workspace
Release history
1- releasecurrenta3768d0warn2 weeks ago
Contents
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Reviews
No reviews yet. Be the first.
Related
Guizang Ppt Skill
AI-agent Skill for generating polished HTML slide decks: editorial magazine and Swiss layouts, image prompts, social covers, and a WebGL/low-power presentation runtime.
Gpt Researcher
An autonomous agent that conducts deep research on any data using any LLM providers
Planning With Files
Claude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition.
mh install skills/gws-gmail-read