gws-gmail

Send, read, and manage Gmail messages, drafts, labels, and account settings. Seven helper commands cover common workflows: send, triage unread messages, reply, reply-all, forward, read message bodies, and watch for new emails in real-time Full Gmail API access via users resource with methods for profiles, drafts, history, labels, messages, settings, threads, and push notifications Use gws schema to inspect method signatures and required parameters before building CLI calls with --params and --json flags Requires gws binary and authentication setup documented in gws-shared/SKILL.md

INSTALLATION
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

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.

BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card