> gws-gmail
Gmail: Send, read, and manage email.
fetch
$
curl "https://skillshub.wtf/googleworkspace/cli/gws-gmail?format=md"SKILL.md•gws-gmail
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.
> related_skills --same-repo
> recipe-watch-drive-changes
Subscribe to change notifications on a Google Drive file or folder.
> recipe-sync-contacts-to-sheet
Export Google Contacts directory to a Google Sheets spreadsheet.
> recipe-share-folder-with-team
Share a Google Drive folder and all its contents with a list of collaborators.
> recipe-share-event-materials
Share Google Drive files with all attendees of a Google Calendar event.
┌ stats
installs/wk0
░░░░░░░░░░github stars21.3K
██████████first seenMar 18, 2026
└────────────