Skills gws-gmail

📦

gws-gmail

Name: gws-gmail
Author: googleworkspace

v0.23.0 Content revision r2 Safe ⚙️ External commands📁 Filesystem access

Manage Gmail with Google Workspace CLI

Managing Gmail through API commands requires accurate resource names and parameters. This skill guides Claude and Codex through supported Gmail CLI workflows.

Supports: Claude Codex Code(CC)

🥈 81 Silver

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request

Review the Skillstore skill "gws-gmail" from https://skillstore.io/skills/googleworkspace-gws-gmail.md and its manifest at https://skillstore.io/api/skills/googleworkspace-gws-gmail/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Markdown detail GET /skills/googleworkspace-gws-gmail.md Signed manifest GET /api/skills/googleworkspace-gws-gmail/manifest Signed lockfile GET /api/skills/googleworkspace-gws-gmail/lockfile

Test it

Using "gws-gmail". Show unread messages from today.

Expected outcome:

09:15 | billing@example.com | Invoice available
11:42 | teammate@example.com | Project update

Using "gws-gmail". Prepare a reply confirming Friday at 10:00.

Expected outcome:

Draft prepared: Friday at 10:00 works for me. I will wait for your approval before sending.

Using "gws-gmail". Which Gmail resources can this skill manage?

Expected outcome:

It covers profiles, drafts, history, labels, messages, settings, threads, and mailbox notification watches.

Security Audit

Safe

v5 • 8/5/2026 Open versioned report

All 30 static findings are false positives caused by Markdown backticks, code fences, and fixed sibling-document links. No prompt injection or malicious intent was found.

Files scanned

Lines analyzed

Review items

False positives ignored

Risk Factors

No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.

Audited by: codex View Audit History →

Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report

Copy report link

https://skillstore.io/skills/googleworkspace-gws-gmail/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/googleworkspace-gws-gmail/security.svg)](https://skillstore.io/skills/googleworkspace-gws-gmail?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/googleworkspace-gws-gmail?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/googleworkspace-gws-gmail/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/googleworkspace-gws-gmail.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Academic citations (APA · BibTeX · CFF)

APA citation

googleworkspace. (2026). gws-gmail security audit report (audit version 5) [Author version 0.23.0]. Skillstore. https://skillstore.io/skills/googleworkspace-gws-gmail/audits/5

BibTeX citation

@techreport{googleworkspace-googleworkspace-gws-gmail-2026,
  author = {googleworkspace},
  title = {gws-gmail security audit report (audit version 5)},
  institution = {Skillstore},
  year = {2026},
  number = {5},
  url = {https://skillstore.io/skills/googleworkspace-gws-gmail/audits/5},
  note = {Author version 0.23.0}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "gws-gmail security audit report (audit version 5)"
version: "0.23.0"
type: report
authors:
  - name: "googleworkspace"
date-released: "2026-08-05"
url: "https://skillstore.io/skills/googleworkspace-gws-gmail/audits/5"
identifiers:
  - type: other
    value: "skillstore:googleworkspace-gws-gmail:audit:5"
    description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: High

Architecture

100

Maintainability

Content

Community

100

Spec Compliance

What You Can Build

Triage an inbox

Summarize unread messages by sender, subject, and date before choosing what needs attention.

Automate support replies

Inspect message threads and prepare correctly threaded replies for customer conversations.

Monitor mailbox activity

Configure Gmail watch operations and process new message notifications for an internal workflow.

Try These Prompts

Check my inbox

Show my unread Gmail messages with sender, subject, and date. Do not change any messages.

Read a message

Find the latest message from [sender], then show its body and key headers without modifying it.

Prepare a reply

Draft a concise reply to message [message ID]. Preserve threading and ask for confirmation before sending.

Configure mailbox monitoring

Inspect the Gmail watch schema, propose required parameters for [topic], and configure monitoring only after approval.

Best Practices

Inspect the method schema before every unfamiliar Gmail API call.
Confirm recipients, subject, and message content before sending or forwarding email.
Use the narrowest account permissions that support the requested workflow.

Avoid

Do not send, reply, or forward messages without explicit user approval.
Do not guess resource parameters when schema inspection is available.
Do not expose message bodies, headers, or account data beyond the requested scope.

Frequently Asked Questions

What do I need before using this skill?

Install the gws CLI, authenticate a Google Workspace account, and make the shared Gmail skills available.

Can it send email?

Yes. The referenced send helper supports email delivery, subject to account permissions and user approval.

Can it read and summarize messages?

Yes. It can retrieve message bodies or headers and support unread inbox summaries.

Does it support replies and forwarding?

Yes. Referenced helpers support threaded replies, reply-all actions, and forwarding to new recipients.

Can it monitor new email?

Yes. It describes Gmail watch operations and a helper that streams new messages as NDJSON.

How are command parameters determined?

The skill directs the agent to inspect each method with gws schema before building parameters and request bodies.

Developer Details

Author

googleworkspace

License

MIT

Author version

v0.23.0

Skillstore revision

Version notice

The author-declared version is lower than the previous observed version.

Repository

https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail/

Ref

286d37c9c189ddd1aafd3548415fb031d1df79d5

Maintenance freshness

8/6/2026

Usage

9 downloads · 85 views

File structure

📄 SKILL.md