Gws Gmail
A comprehensive Gmail wrapper that handles the common email operations you actually need. Built on Google Workspace CLI, it covers sending, reading, replying, forwarding, and inbox triage without forcing you to wrestle with raw Gmail API calls. The helper commands like `+triage` for unread summaries and `+reply` with automatic threading save you from implementing message parsing yourself. Authentication and security are handled through the shared GWS framework. If you're building anything that needs to interact with Gmail programmatically, this beats writing your own API integration from scratch.
- skills.sh installs
- 84.3K
- GitHub stars
- 32.2K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add googleworkspace/cli --skill gws-gmail --agent claude-codeInstalls into .claude/skills of the current project.
Files
gmail (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/googleworkspace/cli
- Categories
- CLI & Terminal, Office & Documents
More from googleworkspace/cli
All 113- Gws Drive76.5K
- Gws Gmail Send76.1K
- Gws Shared68K
- Gws Calendar62.9K
- Gws Sheets60.7K
- Gws Docs60.2K
- Gws Sheets Read52K
- Gws Docs Write51.5K
- Gws Calendar Agenda50.9K
- Gws Drive Upload50.6K
- Gws Calendar Insert49.5K
- Gws Gmail Triage48.2K
- Gws Sheets Append48K
- Gws Tasks46.3K
- Gws Slides42.9K
- Gws Forms42.4K
- Gws Meet42.2K
- Gws Gmail Read42.1K
- Gws Keep39.9K
- Gws Gmail Watch38.1K
- Gws Gmail Reply36K
- Gws Gmail Forward34.5K
- Gws Workflow34.3K
- Gws Chat33.9K
Recommended
More CLI & Terminal
firecrawl-scrapefirecrawl/cliExtract clean markdown from any URL, including JavaScript-rendered SPAs. Use this skill whenever the user provides a URL and wants its content, says "scrape", "84.2Kskills.sh installsfirecrawl-agentfirecrawl/cliAI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites81.9Kskills.sh installsfirecrawl-crawlfirecrawl/cliBulk extract content from an entire website or site section. Use this skill when the user wants to crawl a site, extract all pages from a docs section, bulk-scr81.2Kskills.sh installsfirecrawl-mapfirecrawl/cliDiscover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all UR80.7Kskills.sh installsfirecrawl-downloadfirecrawl/cliDownload an entire website as local files — markdown, screenshots, or multiple formats per page. Use this skill when the user wants to save a site locally, down80.3Kskills.sh installs