gws-gmail: a Claude Code skill by Google Workspace

Official

For gws CLI users who want Claude to read, triage, send and reply to Gmail from the terminal. Skip it if you would rather not give a command-line tool mailbox access.

Copy install command View the source

Score: 79of 100
Rank: #64of 239
Installs: 84.7Kon skills.sh
Security: Mixed 5 scanners
Updated: Nov 32026
Context: ~11tokens always

Install

npx skills add https://github.com/googleworkspace/cli --skill gws-gmail

Run it in your terminal. View the source

Using the Claude app rather than Claude Code? You can add a skill there too. How to add it in the app

What does gws-gmail do?

gws-gmail is a Claude skill that maps Gmail onto the gws command-line tool. It first sends Claude to the gws-shared skill for sign-in, flags and safety rules. It lists helper commands: +send, +triage for an unread inbox summary, +reply, +reply-all and +forward with threading handled, +read to pull a message body or headers, and +watch to stream new mail as NDJSON. For anything else it exposes the raw Gmail API resources, such as drafts, labels, threads, history and settings. Before calling a method, Claude runs gws schema gmail.<resource>.<method> to learn its parameters.

When should you use gws-gmail?

Use it when

Summarizing unread email from the terminal
Replying to or forwarding a message without opening Gmail
Managing labels or drafts through scripts

Skip it when

You do not use the gws command-line tool
Your mail is not on Gmail

What it needs and what it can touch

You need

The gws CLI on your PATH, signed in to a Google account
The gws-shared skill

What it can do

Runs gws commands that read and send email
Sends data to an outside service (Gmail)

From reading its instructions, not from running it.

Why it scores 79

Strongest on upkeep (100 of 100), weakest on adoption (59).

Adoption35 points 59
Upkeep20 points 100
Trust20 points 97
Quality15 points 70
Reader answers10 points Not enough answers yet, so this does not count

How the formula works

Is gws-gmail safe to install?

At least one scanner raised a medium warning. Read the results below. Scanners often miss what other scanners catch, and a skill can change after a scan. Read its source before you install it.

Scanner	Result	Date
Gen Agent Trust Hub	Passed	Sep 14, 2026
Socket	Passed	Sep 14, 2026
Snyk	Medium risk	Sep 14, 2026
Runlayer	Passed	Mar 9, 2026
ZeroLeaks	Passed	Apr 16, 2026

Details

Installs: 84,650
Repository stars: 32,243
Last repository change: Nov 3, 2026
Tokens always loaded: about 11
Tokens when used: about 445
License: Apache-2.0
Data confidence: High

Alternatives to gws-gmail

All skills for this job

gws-gmail-send

For people using the Google Workspace CLI who want Claude to send or draft Gmail messages.

Score 79 76.2K installs Official

Get gws-gmail-send
gws-shared

For people using the gws Google Workspace CLI who want Claude to call it correctly.

Score 81 68.2K installs Official

Get gws-shared
notion-api

For people who want Claude to read and change Notion pages and databases through the REST API.

Score 59 103K installs

Get notion-api
summarize

For anyone who wants quick summaries or transcripts of links, YouTube videos, podcasts and PDFs.

Score 69 22.6K installs

Get summarize