Skip to content

Google Workspace CLI: Gmail

Read, send and triage Gmail through the gws command-line tool.

Community, verifiedby Google Workspace (googleworkspace org)Checked October 18, 2026

One of the skills that ship with the Google Workspace CLI, a popular tool published in Google's googleworkspace GitHub organization. It teaches Claude the gws commands for Gmail, and sibling skills cover Drive, Docs, Sheets, Calendar and more.

Who it is for

  • Professionals living in Gmail
  • Operations staff
  • Developers automating Workspace

Prompts to try

Once the skill is installed, ask for the result in plain words. Claude picks the skill up on its own.

Prompt 1
Triage my unread Gmail and draft replies to anything urgent
Prompt 2
Find the last invoice email from Acme and save the attachment to Drive
Prompt 3
Send a follow-up email to everyone who attended yesterday's meeting

How to install it

In Claude Code

  1. npm install -g @googleworkspace/cli
  2. npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

In Claude.ai

Not practical in Claude.ai because the skill drives local command-line tools, so use Claude Code.

Good to know

Run gws auth setup once; it needs a Google Cloud project and the gcloud CLI, or a manual OAuth setup.

Unlock the install steps

Free. Leave your email once to open the install steps for all 149 skills, and get the best new skills each month.

No spam. One click to unsubscribe. We use your email to send you the course and AI tips.

How we checked it

Confirmed SKILL.md at skills/gws-gmail/SKILL.md in googleworkspace/cli via the GitHub API; skill folder last changed 2026-03-31, repo has 31,609 stars and was pushed 2026-10-06; the README states it is not an officially supported Google product, so it is listed as community.

Source: github.com/googleworkspace/cli/tree/main/skills/gws-gmail