gws-gmail
Gmail: Send, read, and manage email.
pinned to #a3768d0updated 2 days ago
Ask your AI client: “install skills/gws-gmail”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/gws-gmailmetahub 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
30,273
Last commit
2 days 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 days ago
Documentation
6 passed3 warningsDescription qualitywarn
Only 6 words · 36 chars — below the 15-word bar, listed anyway as an official artifact
A skill's description doubles as its trigger. Describe what it does, when to use it, what file types it handles.
Description is substantivewarn
Description is 6 words — thinner than the 8-word floor.
Say what it does AND when to use it. A model choosing between tools has only this text to go on.
Homepage or repository declaredwarn
No homepage or repository declared.
Add a "homepage" or "repository" field to SKILL.md.
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
Documentation present and substantive
Documentation present (SKILL.md, 272 words).
Documentation shows usage
Documentation includes 2 code examples.
Release history
1- releasecurrenta3768d0warn2 days ago
Contents
gmail (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws gmail <resource> <method> [flags]
Helper Commands
| Command | Description |
|---|---|
+send | Send an email |
+triage | Show unread inbox summary (sender, subject, date) |
+reply | Reply to a message (handles threading automatically) |
+reply-all | Reply-all to a message (handles threading automatically) |
+forward | Forward a message to new recipients |
+read | Read a message and extract its body or headers |
+watch | Watch for new emails and stream them as NDJSON |
API Resources
users
getProfile— Gets the current user's Gmail profile.stop— Stop receiving push notifications for the given user mailbox.watch— Set up or update a push notification watch on the given user mailbox.drafts— Operations on the 'drafts' resourcehistory— Operations on the 'history' resourcelabels— Operations on the 'labels' resourcemessages— Operations on the 'messages' resourcesettings— Operations on the 'settings' resourcethreads— Operations on the 'threads' resource
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws gmail --help
# Inspect a method's required params, types, and defaults
gws schema gmail.<resource>.<method>
Use gws schema output to build your --params and --json flags.
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/gws-gmail