
Description
Gmail: Send, read, and manage email.
SKILL.md
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.
More skills from the cli repository
View all 95 skillsgws-admin-reports
generate Google Workspace audit and usage reports
Jul 12AuditGoogle WorkspaceLogsReportinggws-calendar
manage Google Calendar events and schedules
Jul 12Google CalendarGoogle WorkspaceSchedulinggws-calendar-agenda
show upcoming Google Calendar events
Jul 12Google CalendarGoogle WorkspaceMeetingsgws-calendar-insert
create Google Calendar events
Jul 12Google CalendarGoogle WorkspaceSchedulinggws-chat
manage Google Chat spaces and messages
Jul 12Google WorkspaceMessaginggws-chat-send
send messages to Google Chat spaces
Jul 12Google WorkspaceMessaging
More from Google Workspace
View publishergws-classroom
manage Google Classroom rosters and coursework
cli
Jul 12EducationGoogle Workspacegws-docs
read and write Google Docs
cli
Jul 12DocumentsGoogle DocsGoogle Workspacegws-docs-write
append text to Google Docs
cli
Jul 12DocumentsGoogle DocsGoogle WorkspaceWritinggws-drive
manage files in Google Drive
cli
Jul 12File StorageGoogle DriveGoogle Workspacegws-drive-upload
upload files to Google Drive
cli
Jul 12File StorageFile UploadsGoogle DriveGoogle Workspacegws-events
subscribe to Google Workspace events
cli
Jul 12AutomationGoogle WorkspaceNotifications