gmail (v1)

SkillCommunication

Lets your agent send, read, and manage Gmail email.

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

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

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.

Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

gmail (v1)Start free
About this skill

Gmail: Send, read, and manage email.

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

CommandDescription
+sendSend an email
+triageShow unread inbox summary (sender, subject, date)
+replyReply to a message (handles threading automatically)
+reply-allReply-all to a message (handles threading automatically)
+forwardForward a message to new recipients
+readRead a message and extract its body or headers
+watchWatch 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

Ahel review

  • S4info
    community integration, published by googleworkspace, not gmail

Automated review, not a security audit. Ruleset v1.

Ahel recommends instead

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