Gws Gmail | Agent Skills

65K installs

•

googleworkspace/cli

•

by Googleworkspace

Score

8.5

/ 10

Installs

65K

Repo Stars

29.9K

Last Updated

0d ago

Fresh

Quality Ratio

93%

Description

Verified

Language

Rust

First Published

Mar 2026

Summary

The Gws Gmail agent skill enables developers to programmatically interact with Google Workspace Gmail accounts, facilitating tasks like sending emails, reading inbox summaries, and managing mailboxes directly through agent commands. It is most beneficial for developers building automation scripts, notification systems, or custom integrations that require programmatic control over email operations within a Google Workspace environment. This is a niche skill with a smaller but dedicated user base, catering to specific integration needs within the Google Workspace ecosystem. Developers can leverage helper commands such as `+send` to dispatch emails, `+triage` for quick unread inbox summaries, and `+watch` to stream new emails in real-time. It provides access to the full Gmail API, including resources for `users`, `messages`, `drafts`, and `labels`, allowing for granular control over email data and settings. The `gws schema` command helps inspect required parameters for specific API methods. This agent skill requires a foundational understanding of the GWS shared skill for authentication and global flags.

Skill Definition

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.

How to Use

Use in O-mega

Claude Code

npx skills add googleworkspace/cli gws-gmail