Office & Data COMMUNITY New

gws-gmail

With gws-gmail you send, read and manage Gmail messages through the gws command line tool, including replies that stay in the right thread and an overview of unread mail.

Level ●● Intermediate
Saves switching between the terminal and the Gmail interface for routine email
Version v0.22.5
Updated 2026-11-16
Available in: claude-codecoworkclaude-desktop

What is gws-gmail?

gws-gmail is a skill for Claude Code that teaches Claude to work with Gmail through the gws command line tool. It comes from the googleworkspace/cli repository and describes how Claude sends, reads, replies to and forwards messages, summarizes unread mail and accesses Gmail API resources such as drafts, labels, threads and settings.

For common tasks the skill provides helper commands such as '+send', '+reply' or '+triage'. For everything else, Claude first looks up the right method with 'gws gmail --help' and uses 'gws schema' to check which parameters are required, what types they have and which defaults apply. Claude then builds the flags for the actual call from that output.

The skill is worth it if you use Gmail, for example as part of Google Workspace, and want to handle or automate email tasks from within Claude. You need the gws program installed. Sign in, global flags and security rules are covered by a separate skill called gws-shared, which you can create with 'gws generate-skills' if it is missing.

Who it is for

For teams and individuals who use Gmail or Google Workspace and want to handle or automate email tasks from Claude Code, ideally with some command line experience.

Use cases

  • You start your day and have Claude list unread email by sender, subject and date with '+triage'.
  • A customer sends a follow-up question, and Claude drafts a reply with '+reply' that lands in the existing thread.
  • You want to check or adjust labels, drafts or mailbox settings by script without opening the Gmail interface.

What gws-gmail does

Send, reply, forward

Use '+send' for new messages and '+reply' or '+reply-all' to answer, with the skill keeping the reply in the correct thread. '+forward' passes a message on to new recipients.

Triage your inbox with '+triage'

'+triage' gives you an overview of unread messages with sender, subject and date, so you can see at a glance what is waiting in your inbox.

Extract messages with '+read'

'+read' opens a single message and returns either its body or its headers, for example so Claude can process the content further.

Monitor new mail with '+watch'

'+watch' waits for incoming email and outputs it continuously as NDJSON. This works as input for your own evaluations or automations.

Access to the Gmail API

Through the users resource you reach drafts, history, labels, messages, settings and threads, can query the profile and set up or stop push notifications for the mailbox.

Check methods before calling

Before each API call, Claude reads a method's requirements with 'gws schema' and derives the flag values from it instead of guessing parameters.

Say this to activate the skill

"Summarize my unread email with +triage.""Reply to the latest email from sales and confirm the meeting.""Forward this message to the project team.""Show me all labels in my Gmail account."

Install

npx skills add googleworkspace/cli --skill gws-gmail

The command installs the original version from the author's repository (Vercel skills CLI, needs Node.js), add -g for all projects. We do not host a copy: updates come straight from the author. Need help with setup? How to install skills →

Figures with source and date

GitHub stars
≈ 32,300
Installs
85,300
On skills.sh since
4 Mar 2026
Last change in the repository
30 Oct 2026
Licence
Apache-2.0

As of 16 Nov 2026. Sources: GitHub, skills.sh. The figures change daily; we show the state of our last lookup.

Checked automatically

Version 0.22.5, checked on 16 Nov 2026.

  • Automated check on 2026-11-16 (revision cd3697e): 1 files in the skill folder read by pattern search. It found no hidden characters, no instructions to override rules, no download-and-run and no access to credentials.

Independent checks on skills.sh, as of 16 Nov 2026

Gen Agent Trust Hub Pass
Socket Pass
Snyk Warn

Full results on skills.sh ↗

Good to know

  • The skill requires the gws program to be installed and works with the Gmail account you signed in to with gws.
  • Sign in, global flags and security rules live in the separate gws-shared skill. If it is missing, create it with 'gws generate-skills'.
  • '+send', '+reply', '+reply-all' and '+forward' send real messages. Check recipients and text before you let Claude send.
  • When Claude reads email or monitors it with '+watch', the message content enters your conversation with Claude.
  • One auditor on skills.sh reports a warning (Snyk). Read its notes before bringing the skill into projects with sensitive data.
  • The check is an automated pattern search, not a security guarantee, and reads the skill folder only. The command always installs the author's current version; later versions have not been reviewed by us.

Frequently asked questions about gws-gmail

What is gws-gmail?

gws-gmail is a skill that lets Claude operate Gmail through the gws command line tool. It covers sending, reading, replying, forwarding and triaging unread mail and gives access to the Gmail API resources.

How do I install gws-gmail?

You install gws-gmail with 'npx skills add googleworkspace/cli --skill gws-gmail'. You also need the gws program and the gws-shared skill for sign in and security rules, which you can create with 'gws generate-skills' if needed.

Is gws-gmail free?

gws-gmail is licensed under Apache-2.0, so you can use it freely. You need a Gmail account for access. The skill says nothing about possible costs on the Google side.

Who is gws-gmail for?

gws-gmail is for you if you use Gmail or Google Workspace and want to handle recurring email tasks from Claude, such as triaging your inbox, writing threaded replies or managing labels and drafts.

What data does gws-gmail send?

gws-gmail accesses the Gmail API of your account through gws. When Claude reads messages, their content enters your conversation with Claude. Commands like '+send' or '+forward' send real email. The skill describes no other data transfer.

Share this skill

About this skill

gws-gmail comes from googleworkspace and is an open-source project maintained by its author and community.

Author: googleworkspace / github.com. Source: github.com/googleworkspace/cli/tree/main/skills/gws-gmail. Licence: Apache-2.0.

Curated by Collective Brain, an AI and automation digital agency from Hamburg, together with WhiteFox Automations. More vetted skills in the skills catalog.

Working in Germany, Austria or Switzerland? We help teams roll out Claude, in English or German.

Want this skill tailored to your team?

gws-gmail is a strong starting point. A skill gets really powerful once it knows your workflows, templates and tone of voice. We build custom skills for teams, from analysis to rollout, and connect them to our work in AI consulting.

Request a custom skill →