From gws
Send, read, triage, reply, forward, and watch Gmail emails via gws CLI. Access API resources like messages, threads, drafts, labels, and user profile.
npx claudepluginhub wadewarren/gws-claude-pluginThis 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.
Automates Gmail operations like searching, reading, sending emails, managing drafts/labels via Python CLI scripts with standalone OAuth. Requires Google Workspace.
Manages Gmail across multiple accounts: read, search, send, reply to emails, and handle labels using Python scripts and API with structured sending workflow.
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) |
+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 |
+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.