What does the gws gmail skill do?

It lets an agent send, read, reply to, forward, and manage Gmail email. It works through the gws command-line tool and covers messages, drafts, labels, threads, and watching for new mail.

How do I send an email with this skill?

Use the +send helper command. It is one of the helper commands listed for common actions, alongside +triage, +reply, +reply-all, +forward, +read, and +watch.

Does it handle email threading when replying?

Yes. The +reply and +reply-all helper commands handle threading automatically.

gmail (v1)

SkillCommunication

The gws gmail skill lets an agent send, read, reply to, and manage Gmail email through the gws command-line tool. It covers common actions with helper commands and gives full access to Gmail API resources such as messages, drafts, labels, and threads. It can also watch for new emails and stream them as they arrive.

Use gmail (v1) in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add gmail (v1) and connect your AI. About a minute.

Claude ChatGPT Ahel Desktop

Also: Claude Code · Cursor · Codex

Then ask your AI: use the gmail (v1) skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.

No other account needed.

Make sure the gws command-line tool is installed and available.

gmail (v1)Start free

What your AI can do with it

Send an email with the +send helper command
Show an unread inbox summary with sender, subject, and date using +triage
Reply or reply-all to a message with threading handled automatically
Forward a message to new recipients with +forward
Read a message and extract its body or headers with +read
Watch for new emails and stream them as NDJSON with +watch

Getting started

Make sure the gws command-line tool is installed and available.
Read the gws-shared skill for auth, global flags, and security rules, or run gws generate-skills to create it if missing.
Browse available resources and methods with gws gmail --help.
Inspect a method's required params, types, and defaults with gws schema gmail.<resource>.<method>.
Run gws gmail <resource> <method> [flags] to perform the action.

What this skill tells your AI

The instructions your AI receives, as published by googleworkspace/cli in skills/gws-gmail/SKILL.md and read by Ahel’s review.

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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

getProfile — Gets the current user's Gmail profile.
stop — Stop receiving push notifications for the given user mailbox.
watch — Set up or update a push notification watch on the given user mailbox.
drafts — Operations on the 'drafts' resource
history — Operations on the 'history' resource
labels — Operations on the 'labels' resource
messages — Operations on the 'messages' resource
settings — Operations on the 'settings' resource
threads — Operations on the 'threads' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws gmail --help

# Inspect a method's required params, types, and defaults
gws schema gmail.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Signals

GitHub stars: 31k
Forks: 2k
Last commit: Sep 2026
Installs: 79k installs

Ahel review

S4info
community integration, published by googleworkspace, not gmail

Automated review, not a security audit. Ruleset v1+k2.

Others that do the same job

gws-gmail
Skill · googleworkspace

Questions

What does the gws gmail skill do?: It lets an agent send, read, reply to, forward, and manage Gmail email. It works through the gws command-line tool and covers messages, drafts, labels, threads, and watching for new mail.
How do I send an email with this skill?: Use the +send helper command. It is one of the helper commands listed for common actions, alongside +triage, +reply, +reply-all, +forward, +read, and +watch.
Does it handle email threading when replying?: Yes. The +reply and +reply-all helper commands handle threading automatically.

Advanced

Item type: skill
Key: gws-gmail
Source: github.com/googleworkspace/cli

github.com/googleworkspace/cli