← Back to Skills Marketplace
Gws Gmail Read
by
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
390
Downloads
0
Stars
1
Active Installs
13
Versions
Install in OpenClaw
/install gws-gmail-read
Description
Gmail: Read a message and extract its body or headers.
README (SKILL.md)
gmail +read
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Read a message and extract its body or headers
Usage
gws gmail +read --id \x3CID>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--id |
✓ | — | The Gmail message ID to read |
--headers |
— | — | Include headers (From, To, Subject, Date) in the output |
--format |
— | text | Output format (text, json) |
--html |
— | — | Return HTML body instead of plain text |
--dry-run |
— | — | Show the request that would be sent without executing it |
Examples
gws gmail +read --id 18f1a2b3c4d
gws gmail +read --id 18f1a2b3c4d --headers
gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'
Tips
- Converts HTML-only messages to plain text automatically.
- Handles multipart/alternative and base64 decoding.
See Also
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Usage Guidance
This skill itself is just documentation for the 'gws' CLI, but it defers authentication details to ../gws-shared/SKILL.md which is not included or declared. Before installing or enabling: (1) locate and read the referenced gws-shared SKILL.md to see exactly how credentials are provided and what env vars or config paths are used; (2) verify the 'gws' binary is trusted and from a reputable source; (3) confirm the OAuth/service-account scopes and ensure least privilege (only read-mail if that's all you need); (4) ensure the agent will not be granted broad filesystem access that would expose other credentials; (5) if you cannot inspect the referenced shared file or the gws client, treat this as a red flag and do not enable the skill. If you want higher assurance, request the publisher to include explicit declarations of required env vars/config paths and to bundle or reference a verified gws release URL.
Capability Analysis
Type: OpenClaw Skill
Name: gws-gmail-read
Version: 1.0.12
The skill bundle provides a standard interface for reading Gmail messages using the 'gws' CLI tool. The documentation in SKILL.md and metadata in _meta.json are consistent with the stated purpose of extracting email bodies and headers, with no evidence of malicious instructions, data exfiltration, or suspicious execution patterns.
Capability Assessment
Purpose & Capability
The declared purpose (read Gmail) matches the required binary 'gws' and the runtime examples. However the SKILL.md points to ../gws-shared/SKILL.md for auth/global flags; the registry metadata lists no required env vars or config paths. That is an inconsistency: authentication requirements are implied but not declared.
Instruction Scope
The instructions themselves simply call the gws CLI to read a message, which is in-scope. But they explicitly instruct the agent to read an external file (../gws-shared/SKILL.md) for auth and security rules. That external dependency is not present in the package metadata and may contain instructions to access credentials, config paths, or other system state — the runtime behavior is therefore underspecified and potentially broader than advertised.
Install Mechanism
This is an instruction-only skill with no install spec and no code files. Nothing is written to disk by the skill itself. Risk depends on the external 'gws' binary (not supplied here) rather than the skill bundle.
Credentials
The skill declares no required environment variables or credentials, yet it depends on authentication provided by a separate shared SKILL.md. Expect that OAuth tokens, service-account keys, or other credentials are required in practice; those credentials are not documented in this skill, which is disproportionate and opaque.
Persistence & Privilege
The skill does not request always:true, does not modify other skills' configs in the bundle, and is user-invocable only. Autonomous invocation is allowed (platform default) but there is no extra persistence or elevated privilege declared by this skill itself.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-gmail-read - After installation, invoke the skill by name or use
/gws-gmail-read - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.12
- Updated version in SKILL.md metadata from 0.22.4 to 0.22.5.
v1.0.11
- Bumped version in SKILL.md metadata from 0.22.3 to 0.22.4.
v1.0.10
- Updated skill version number in documentation from 0.22.2 to 0.22.3 in SKILL.md.
- No changes to command usage or features.
v1.0.9
- Updated skill version from 0.22.1 to 0.22.2 in documentation.
- No functional or usage changes; documentation version bump only.
v1.0.8
- Updated version metadata from 0.22.0 to 0.22.1 in SKILL.md.
- No changes to features, usage, flags, or documentation content.
v1.0.7
- Bumped skill version to 0.22.0 in metadata (was 0.21.2).
- No other content or usage changes.
v1.0.6
- Updated skill version in documentation from 0.21.1 to 0.21.2.
- No changes to usage, options, or functionality documented.
- Documentation content and examples remain unchanged.
v1.0.5
- Updated skill version from 0.20.1 to 0.21.1 in SKILL.md.
v1.0.4
- Updated skill version from 0.20.0 to 0.20.1 in documentation.
- No functional or usage changes; documentation version bump only.
v1.0.3
- Bumped version from 0.19.0 to 0.20.0 in metadata.
- No changes to features, usage, flags, or documentation content.
v1.0.2
- Updated version metadata format and moved version under the metadata section.
- No functional changes; documentation formatting and metadata structure improved for consistency.
v1.0.1
No functional changes; SKILL.md formatting updated.
- Metadata "requires" list reformatted to YAML array style for consistency.
- No changes to usage, flags, or functionality.
v1.0.0
- Initial release of gws-gmail-read.
- Enables reading Gmail messages by message ID.
- Supports extracting message body or headers, with options for text or HTML output.
- Includes flags for custom output format, including JSON and dry-run mode.
- Automatically converts HTML-only messages to plain text and handles multipart and base64 decoding.
- Documentation covers usage, flags, and example commands.
Metadata
Frequently Asked Questions
What is Gws Gmail Read?
Gmail: Read a message and extract its body or headers. It is an AI Agent Skill for Claude Code / OpenClaw, with 390 downloads so far.
How do I install Gws Gmail Read?
Run "/install gws-gmail-read" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Gmail Read free?
Yes, Gws Gmail Read is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Gmail Read support?
Gws Gmail Read is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Gmail Read?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.12.
More Skills