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' resource
history — Operations on the 'history' resource
labels — Operations on the 'labels' resource
messages — Operations on the 'messages' resource
settings — Operations on the 'settings' resource
threads — 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.
1---2name: gws-gmail3description: gmail (v1)4---5# gmail (v1)67> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, stop and repair the declarative skill deployment.89```bash10gws gmail <resource> <method> [flags]11```1213## Helper Commands1415| Command | Description |16|---------|-------------|17| [`+send`](../gws-gmail-send/SKILL.md) | Send an email |18| [`+triage`](../gws-gmail-triage/SKILL.md) | Show unread inbox summary (sender, subject, date) |19| [`+reply`](../gws-gmail-reply/SKILL.md) | Reply to a message (handles threading automatically) |20| [`+reply-all`](../gws-gmail-reply-all/SKILL.md) | Reply-all to a message (handles threading automatically) |21| [`+forward`](../gws-gmail-forward/SKILL.md) | Forward a message to new recipients |22| [`+read`](../gws-gmail-read/SKILL.md) | Read a message and extract its body or headers |23| [`+watch`](../gws-gmail-watch/SKILL.md) | Watch for new emails and stream them as NDJSON |2425## API Resources2627### users2829 - `getProfile` — Gets the current user's Gmail profile.30 - `stop` — Stop receiving push notifications for the given user mailbox.31 - `watch` — Set up or update a push notification watch on the given user mailbox.32 - `drafts` — Operations on the 'drafts' resource33 - `history` — Operations on the 'history' resource34 - `labels` — Operations on the 'labels' resource35 - `messages` — Operations on the 'messages' resource36 - `settings` — Operations on the 'settings' resource37 - `threads` — Operations on the 'threads' resource3839## Discovering Commands4041Before calling any API method, inspect it:4243```bash44# Browse resources and methods45gws gmail --help4647# Inspect a method's required params, types, and defaults48gws schema gmail.<resource>.<method>49```5051Use `gws schema` output to build your `--params` and `--json` flags.
Run npx skillmds@latest add wimpysworld/gws-gmail 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 (v1) 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