Skills gws-gmail-read

📦

gws-gmail-read

Name: gws-gmail-read
Author: googleworkspace

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

Read Gmail Messages with GWS

Finding a specific email body or header through a general mailbox workflow can take unnecessary steps. This skill retrieves one Gmail message directly by ID.

Supports: Claude Codex Code(CC)

🥈 80 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-read" from https://skillstore.io/skills/googleworkspace-gws-gmail-read.md and its manifest at https://skillstore.io/api/skills/googleworkspace-gws-gmail-read/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-read.md Signed manifest GET /api/skills/googleworkspace-gws-gmail-read/manifest Signed lockfile GET /api/skills/googleworkspace-gws-gmail-read/lockfile

Test it

Using "gws-gmail-read". Read message 18f1a2b3c4d as plain text.

Expected outcome:

The message body is returned as readable plain text, including content converted from HTML when necessary.

Using "gws-gmail-read". Read message 18f1a2b3c4d with headers.

Expected outcome:

From: sender@example.com
To: recipient@example.com
Subject: Project update
Date: Tue, 5 Aug 2026
Body: The project update is ready for review.

Using "gws-gmail-read". Show the request for message 18f1a2b3c4d without executing it.

Expected outcome:

A dry-run preview describes the Gmail read request without retrieving the message.

Security Audit

Safe

v2 • 8/5/2026 Open versioned report

All 16 static alerts are false positives caused by Markdown syntax, documented Gmail CLI examples, and valid sibling documentation links. No prompt injection, covert execution, path traversal, system reconnaissance, or other semantic security issue was found.

Files scanned

Lines analyzed

Review items

False positives ignored

Risk Factors

⚙️ External commands (9)

SKILL.md:16 SKILL.md:22-24 SKILL.md:24-30 SKILL.md:30-31 SKILL.md:31-32 SKILL.md:32-33 SKILL.md:33-34 SKILL.md:34-38 SKILL.md:38-42

📁 Filesystem access (3)

SKILL.md:16 SKILL.md:51 SKILL.md:52

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-read/audits/2?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

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

HTML badge

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

Embed card

<iframe src="https://skillstore.io/embed/skills/googleworkspace-gws-gmail-read.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-read security audit report (audit version 2) [Author version 0.23.0]. Skillstore. https://skillstore.io/skills/googleworkspace-gws-gmail-read/audits/2

BibTeX citation

@techreport{googleworkspace-googleworkspace-gws-gmail-read-2026,
  author = {googleworkspace},
  title = {gws-gmail-read security audit report (audit version 2)},
  institution = {Skillstore},
  year = {2026},
  number = {2},
  url = {https://skillstore.io/skills/googleworkspace-gws-gmail-read/audits/2},
  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-read security audit report (audit version 2)"
version: "0.23.0"
type: report
authors:
  - name: "googleworkspace"
date-released: "2026-08-05"
url: "https://skillstore.io/skills/googleworkspace-gws-gmail-read/audits/2"
identifiers:
  - type: other
    value: "skillstore:googleworkspace-gws-gmail-read:audit:2"
    description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: High

Architecture

100

Maintainability

Content

Community

Spec Compliance

What You Can Build

Review a support email

Retrieve a known customer message with headers before preparing a response.

Extract content for a workflow

Read one message body in JSON format for controlled downstream processing.

Inspect an HTML newsletter

Retrieve the original HTML body when plain text conversion omits needed formatting.

Try These Prompts

Read one message

Read the Gmail message with ID [MESSAGE_ID] and return its plain text body.

Include message headers

Read Gmail message [MESSAGE_ID] with its From, To, Subject, and Date headers.

Retrieve the HTML body

Read Gmail message [MESSAGE_ID] and return the HTML body instead of converted plain text.

Prepare structured extraction

Dry-run a JSON request for Gmail message [MESSAGE_ID]. After approval, read it and extract only the body for downstream processing.

Best Practices

Confirm the message ID before reading sensitive content.
Use dry-run mode before integrating the command into automation.
Request only the body format and headers required for the task.

Avoid

Do not expose retrieved email content in public logs or unrelated conversations.
Do not use guessed message IDs as a substitute for Gmail search.
Do not request HTML when plain text is sufficient.

Frequently Asked Questions

What do I need before using this skill?

Install the GWS CLI, configure Google Workspace authentication, and obtain the Gmail message ID.

Can this skill search for messages?

No. It reads a message by known ID and does not provide mailbox search.

Which headers can it include?

It can include From, To, Subject, and Date headers.

Can it return HTML?

Yes. Use the HTML option to return the HTML body instead of plain text.

What happens with HTML-only email?

The command converts HTML-only messages to plain text unless HTML output is requested.

Does dry-run retrieve the message?

No. Dry-run shows the request that would be sent without executing it.

Developer Details

Author

googleworkspace

License

MIT

Author version

v0.23.0

Skillstore revision

Repository

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

Ref

286d37c9c189ddd1aafd3548415fb031d1df79d5

Maintenance freshness

8/6/2026

Usage

3 downloads · 0 views

File structure

📄 SKILL.md