@googleworkspace/gws-gmail

Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.

View in AI SkillSafe app
141362 downloads
0 stars
0 demos
SKILL.md
namegws-gmail
descriptionGmail: Send, read, and manage email.
metadatagws

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

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' 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.

Embed badges

Add these to your README to show the skill's verification status.

SkillSafe verified badge
Verified badge
[![SkillSafe verified badge](https://api.skillsafe.ai/v1/badge/@googleworkspace/gws-gmail/verified)](https://skillsafe.ai/skill/@googleworkspace/gws-gmail/)
Installs badge
Installs badge
[![Installs badge](https://api.skillsafe.ai/v1/badge/@googleworkspace/gws-gmail/installs)](https://skillsafe.ai/skill/@googleworkspace/gws-gmail/)
Scan badge
Scan badge
[![Scan badge](https://api.skillsafe.ai/v1/badge/@googleworkspace/gws-gmail/scan)](https://skillsafe.ai/skill/@googleworkspace/gws-gmail/)
Eval pass rate badge
Eval pass rate
[![Eval pass rate badge](https://api.skillsafe.ai/v1/badge/@googleworkspace/gws-gmail/eval)](https://skillsafe.ai/skill/@googleworkspace/gws-gmail/)