← Back to Skills Marketplace
88
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install gmail-retrieve-email
Description
Atomic node skill to read a specific email via Gmail using the gog CLI.
README (SKILL.md)
Lean Philosophy (Principles)
- Kaizen (改善): This skill is an atomic node, broken down into its simplest, smallest component to eliminate waste and ensure perfection.
- Standardized Work (Hyojun Sagyo): This node represents the most efficient, standardized path for this specific task before automation.
- Jidoka (自働化): This node includes autonomous defect detection. It relies on the CLI's self-healing loop and will report errors if retrieval fails.
Gmail Retrieve Email
This skill allows the agent to retrieve the full contents of a specific email using the native CLI.
Cognitive Directives
WHEN [The contents of a specific email need to be read]
THEN [Execute the native terminal command gog gmail messages get \x3CmessageId> --json]
Schema Example
{
"command": "gog gmail messages get msg_id_123 --json"
}
Expected Output
A JSON object containing the email headers, body, and metadata.
Usage Guidance
This skill simply runs your existing 'gog' CLI to fetch a single Gmail message. Before installing, confirm that 'gog' is the legitimate CLI you expect and that it's authenticated only to accounts you trust. The skill itself does not request credentials, but it will use whatever Gmail access 'gog' already has on the machine — so be mindful that retrieved emails are accessible to the agent and could be forwarded by the agent if policies allow. If you don't already have or trust 'gog' installed, do not enable this skill.
Capability Analysis
Type: OpenClaw Skill
Name: gmail-retrieve-email
Version: 1.0.2
The skill is a straightforward wrapper for the 'gog' CLI tool to retrieve Gmail message content. The instructions in SKILL.md are transparent, align with the stated purpose, and do not contain any indicators of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
The name and description match the instructions: the skill requires the 'gog' binary and tells the agent to run 'gog gmail messages get <messageId> --json' to retrieve an email. Requiring 'gog' is expected for this purpose.
Instruction Scope
SKILL.md only instructs a single explicit CLI command to get a message and expects JSON output. It does not ask to read unrelated files, environment variables, or transmit results to other endpoints.
Install Mechanism
There is no install spec (instruction-only), so nothing is downloaded or written to disk by the skill itself. This is the lowest-risk install posture.
Credentials
The skill declares no env vars, which is proportionate, but it implicitly relies on the 'gog' CLI's existing authentication (local credentials/tokens). Installing or running the skill will let the 'gog' process access whatever Gmail account credentials are already configured on the host.
Persistence & Privilege
The skill is not always-enabled and does not request persistent presence or modification of other skills or system settings. Autonomous invocation is allowed by default (platform behavior) but is not a unique privilege of this skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gmail-retrieve-email - After installation, invoke the skill by name or use
/gmail-retrieve-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Updated to use the native gog CLI for email retrieval instead of the GoogleWorkspace plugin.
- Changed requirements to depend on the gog command-line tool.
- Updated instructions and schema example to reflect new CLI usage.
- Revised description and error handling notes to match the cli-based approach.
v1.0.1
- Expanded OS compatibility from Windows-only to all operating systems.
v1.0.0
Initial release of Gmail Retrieve Email skill.
- Retrieves the full content of a specific email message by unique ID.
- Requires the google-workspace-plugin.
- Outputs email details including subject, sender, recipients, body, labels, and date.
- Reports errors if retrieval fails.
Metadata
Frequently Asked Questions
What is Gmail Retrieve Email?
Atomic node skill to read a specific email via Gmail using the gog CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 88 downloads so far.
How do I install Gmail Retrieve Email?
Run "/install gmail-retrieve-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail Retrieve Email free?
Yes, Gmail Retrieve Email is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail Retrieve Email support?
Gmail Retrieve Email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail Retrieve Email?
It is built and maintained by zvirb (@zvirb); the current version is v1.0.2.
More Skills