Gws Gmail
googleworkspace/cliThis skill enables automated management of Gmail emails, allowing users to send, read, reply, forward, and monitor emails through command-line commands. It provides key capabilities such as viewing unread inbox summaries, managing drafts, labels, and message threads, and setting up push notifications for new emails. Designed for developers and power users, it streamlines email workflows within the Google Workspace ecosystem using structured commands and API integrations.
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
+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.
GitHub Owner
Owner: googleworkspace
GitHub Links
- Website: https://developers.google.com/workspace
- Twitter: https://twitter.com/workspacedevs
Files
+send
+triage
- View: https://github.com/googleworkspace/cli/blob/HEAD/skills/gws-gmail/../gws-gmail-triage/SKILL.md
+reply
+reply-all
- View: https://github.com/googleworkspace/cli/blob/HEAD/skills/gws-gmail/../gws-gmail-reply-all/SKILL.md
+forward
- View: https://github.com/googleworkspace/cli/blob/HEAD/skills/gws-gmail/../gws-gmail-forward/SKILL.md
+watch
SKILL.md
name: gws-gmail version: 1.0.0 description: "Gmail: Send, read, and manage email." metadata: openclaw: category: "productivity" requires: bins: ["gws"] cliHelp: "gws gmail --help"
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 |
+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.