npx claudepluginhub pleaseai/claude-code-plugins --plugin google-workspaceThis skill uses the workspace's default tool permissions.
> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
CLI for sending, reading, and managing Gmail via gws: triage unread inbox, watch new emails, access API resources like messages/threads.
Provides Python CLI scripts to search, read, send, and modify Gmail messages/drafts for Google Workspace accounts using standalone OAuth authentication.
Interact with Gmail via Python CLI: search/read/send emails, create drafts, manage labels (read/archive/star). Standalone OAuth for Google Workspace accounts.
Share bugs, ideas, or general feedback.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws gmail <resource> <method> [flags]
| Command | Description |
|---|---|
+send | Send an email |
+triage | Show unread inbox summary (sender, subject, date) |
+watch | Watch for new emails and stream them as NDJSON |
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' resourceBefore 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.