Skills gws-gmail

📦

gws-gmail

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)

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.

1

Files scanned

62

Lines analyzed

0

Review items

0

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

Security Assessment

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

55

Architecture

100

Maintainability

85

Content

68

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

r2

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

More from googleworkspace

gws-sheets

Manage Google Sheets with the gws CLI

Google Sheets API commands can be difficult to discover and structure correctly. This skill guides Claude and Codex through supported gws resources, methods, and flags.

Office & Reports View

gws-docs

Manage Google Docs with the gws CLI

Google Docs automation can require precise API commands and request formats. This skill guides Claude, Codex, and Claude Code through gws document operations.

Office & Reports View

gws-calendar

Manage Google Calendar with the gws CLI

Calendar administration often requires precise API methods and parameters. This skill guides Claude, Codex, and Claude Code through Google Calendar operations using the gws CLI.

Productivity View

gws-shared

Use Google Workspace CLI Safely

Google Workspace CLI tasks can fail because authentication, flags, and shell quoting vary. This skill provides shared patterns for reliable and safer gws commands.

Office & Reports View

gws-gmail-send

Send Gmail Messages from the Command Line

Preparing Gmail commands with recipients, content, copies, and attachments can be error-prone. This skill guides Claude and Codex through safe gws message sending.

Office & Reports View

gws-tasks

Manage Google Tasks from Your AI Assistant

Managing Google Tasks through an API requires accurate resource names, methods, parameters, and identifiers. This skill guides Google Workspace CLI operations for lists and tasks.

Productivity View

email-drafter

Draft Professional Business Emails

by shubhamsaboo

Writing clear workplace email can take time and create tone concerns. This skill helps draft structured messages for common business situations.

Communication View

linear-projects-write

Create and Update Linear Projects from the CLI

by Bind

Managing Linear projects through the web interface is slow when you work in the terminal or automate workflows. This skill lets you create and update projects with simple commands, so you can manage project data directly from scripts and the command line.

Productivity View

meeting-insights-analyzer

Analyze Meeting Communication Patterns

by 89jobrien

Meeting transcripts are hard to review consistently across many calls. This skill turns transcripts into focused communication feedback with examples and next steps.

Productivity View

prompt-engineer

Optimize AI Prompts With Prompt Engineer

by sickn33

Writing clear prompts is hard when goals are vague or complex. This skill turns rough requests into structured prompts using proven prompt frameworks.

Productivity View

web-cli-teleport

Choose Claude Code Web or CLI

by DNYoussef

Teams lose time when they pick the wrong Claude Code interface for a task. This skill recommends Web, CLI, or a hybrid handoff workflow.

Productivity View

enact-hello-rust

Create Rust Greeting Tools

by EnactProtocol

Developers need a small, predictable example for passing input into a Rust command-line skill. This skill compiles and runs a greeting tool from a name parameter.

Coding & Development View