Officialgoogleworkspace/cli1 file

Gws Gmail

Gmail: Send, read, and manage email.

Specification
Skill ID
googleworkspace/cli/gws-gmail
Publisher
googleworkspace
Repository
cli
Installs
180
Files
1
Synced
Sep 16, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

googleworkspace/cli/gws-gmailInstalls these files
  • SKILL.md

What this skill tells the agent

gmail (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.
gws gmail <resource> <method> [flags]

Helper Commands

CommandDescription
`+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' 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.