gws-gmail
Apache-2.0Updated on Nov 3, 202632,246GitHub stars
The main Gmail skill from the googleworkspace/cli repository.
What the skill teaches
The main Gmail skill from the googleworkspace/cli repository. It teaches an agent how to call the Gmail v1 API through the gws command: the helper commands for sending, triage, replies, forwarding, reading and watching, plus the raw resources for drafts, history, labels, messages, settings and threads. It tells the agent to inspect a method's schema with gws before calling it. It drives the gws command-line tool, which must be installed and signed in with OAuth (or given a service account or token) per the shared gws skill.
Capabilities
- Send, read and manage Gmail messages through gws
- Look up Gmail API method schemas
- Work with drafts, labels, threads and settings
Install
- Run this to add it to Any client:
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Gmail | |
| Publisher | Google Workspace | source |
| Official status | Officialpublished in Google's googleworkspace GitHub org, which Google's own Gmail docs link to; the cli README adds that gws is not an officially supported Google product | source |
| Status | under active development | source |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | Apache-2.0 | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 3, 202632,246 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Sources
- Skill file (SKILL.md)github.com/googleworkspace/cliNov 10, 2026
- GitHub repositorygithub.com/googleworkspace/cli · Backs: Publisher, Status, Activity, LicenceNov 11, 2026
- Licence file (LICENSE)github.com/googleworkspace/cli · Backs: LicenceNov 12, 2026
- Web pagedevelopers.google.com · Backs: Official statusNov 12, 2026
- Folder in the repository (gws-gmail)github.com/googleworkspace/cli · Backs: Includes scriptsNov 10, 2026