SkillsAdd

googleworkspace/cli · Official

gws-gmail

Gmail: Send, read, and manage email.

All-time #375 Trending #965 Hot #5492 First seen Mar 4, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-gmail
View on skills.sh ↗ GitHub repository ↗

Summary

  • Send, read, and manage Gmail messages, drafts, labels, and account settings.
  • Seven helper commands cover common workflows: send, triage unread messages, reply, reply-all, forward, read message bodies, and watch for new emails in real-time Full Gmail API access via users resource with methods for profiles, drafts, history, labels, messages, settings, threads, and push notifications Use gws schema to inspect method signatures and required parameters before building CLI calls with --params and --json flags Requires gws binary and authentication setup documented in gws-shared/SKILL.md

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

gmail-workflows Similar name
claude-office-skills/skills

Automate Gmail with intelligent workflows - attachment management, email organization, auto-arc…

4.3K installs
gmail-skill Similar name
idanbeck/claude-skills

Read, search, send, and draft Gmail emails and Google contacts. Use when the user asks to check…

3.5K installs
gmail Similar name
membranedev/application-skills

Gmail integration. Manage communication data, records, and workflows. Use when the user wants t…

779 installs
gws-gmail Similar name
streakyc/googleworkspacecli

Gmail: Send, read, and manage email.

25 installs
gws-gmail-send Similar name
streakyc/googleworkspacecli

Gmail: Send an email.

25 installs
gws-gmail-reply Similar name
streakyc/googleworkspacecli

Gmail: Reply to a message (handles threading automatically).

25 installs

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 1, 2026

This skill acts as a command-line interface wrapper for Google Workspace Gmail management. It provides instructions for an agent to use the 'gws' tool to read, send, and organize emails. No security issues or malicious patterns were detected.

snyk MEDIUM

Analyzed Apr 1, 2026

[MEDIUM] W011: Third-party content exposure detected (indirect prompt injection risk).

socket Score 0.9000 · 0 alerts

Analyzed Apr 1, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli
gws-gmail-send 69.5K gws-drive 68K gws-shared 59.4K gws-calendar 55.1K gws-sheets 52.5K gws-docs 52K gws-sheets-read 45.1K gws-docs-write 44.6K gws-calendar-agenda 44.2K gws-drive-upload 43.9K

Browse all from googleworkspace/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 30.9K
License LICENSE
Default branch main
Open issues 129
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws gmail --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,018 B
  • docs SUMMARY.md 53 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 74,800 installs

SKILL.md

gmail (v1)

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](../gws-gmail-send/SKILL.md) Send an email
[+triage](../gws-gmail-triage/SKILL.md) Show unread inbox summary (sender, subject, date)
[+reply](../gws-gmail-reply/SKILL.md) Reply to a message (handles threading automatically)
[+reply-all](../gws-gmail-reply-all/SKILL.md) Reply-all to a message (handles threading automatically)
[+forward](../gws-gmail-forward/SKILL.md) Forward a message to new recipients
[+read](../gws-gmail-read/SKILL.md) Read a message and extract its body or headers
[+watch](../gws-gmail-watch/SKILL.md) 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.