← Back to Skills Marketplace
60
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install gmail-search-emails
Description
Atomic node skill to search for emails in 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 the search fails.
Gmail Search Emails
This skill allows the agent to search for emails in Gmail using specific queries with the native CLI.
Cognitive Directives
WHEN [Requested to search for an email or find specific communications]
THEN [Invoke the gog tool with the argument gmail search "query" --json]
Schema Example
{
"args": "gmail search \"from:[email protected] subject:invoice\" --json"
}
Expected Output
A JSON array containing email headers (id, threadId, snippet) or a "no results found" message.
Usage Guidance
This skill appears consistent with its description: it simply runs the local `gog` CLI to search Gmail. Before installing, ensure (1) you trust the `gog` binary (source, integrity), (2) you understand which Gmail account/credentials `gog` is configured to use (it likely uses local OAuth tokens or a config file), and (3) you are comfortable letting an agent invoke `gog` to read/search your messages. If you need tighter control, test in a non-sensitive account or verify/limit `gog`'s permissions first.
Capability Analysis
Type: OpenClaw Skill
Name: gmail-search-emails
Version: 1.0.3
The skill is a straightforward wrapper for the 'gog' CLI tool to search Gmail. The SKILL.md and _meta.json files contain no evidence of malicious intent, obfuscation, or unauthorized data exfiltration. The instructions are clearly aligned with the stated purpose of searching emails and do not attempt to manipulate the agent into performing hidden or harmful actions.
Capability Assessment
Purpose & Capability
Name and description state: search Gmail using the gog CLI. The only declared runtime requirement is the gog binary, which is exactly what the SKILL.md tells the agent to invoke. There are no unrelated binaries or env vars requested.
Instruction Scope
SKILL.md gives a single, constrained runtime directive: call `gog` with `gmail search "query" --json`. It does not instruct the agent to read unrelated files, exfiltrate data to unknown endpoints, or perform privilege-escalating actions.
Install Mechanism
No install specification — instruction-only. Nothing is downloaded or written to disk by the skill itself, which minimizes installation risk.
Credentials
The skill declares no env vars or credentials, which is coherent if the gog CLI is already installed and pre-authenticated. However, accessing Gmail requires authentication (OAuth tokens or similar) that the skill assumes will be provided by the gog CLI or the environment; the skill does not document or request those credentials. Users should verify how gog is authenticated and which Gmail account it will access.
Persistence & Privilege
Skill is not always-enabled and does not request persistent system modifications or elevated privileges. It is user-invocable and follows normal autonomous invocation defaults.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gmail-search-emails - After installation, invoke the skill by name or use
/gmail-search-emails - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Updated the command invocation directive to specify using the `gog` tool directly, clarifying usage.
- Changed schema example to use `"args"` instead of `"command"` for clearer integration.
- No functionality changes; documentation improved for clarity and consistency.
v1.0.2
- Switched email search method from GoogleWorkspace plugin to native gog CLI.
- Updated requirements to use the gog binary instead of the plugin.
- Updated cognitive directives and schema example to show usage of CLI command.
- Adjusted documentation to reflect CLI-based approach.
v1.0.1
- Updated OS support from "windows" to "all" in the skill metadata.
- No functional changes to logic or usage.
v1.0.0
- Initial release of Gmail Search Emails skill.
- Enables searching Gmail for emails using predefined queries via the GoogleWorkspace plugin.
- Returns email headers (id, threadId, snippet) or a "no results found" message.
- Designed as an atomic, standardized node for efficient and reliable email retrieval.
Metadata
Frequently Asked Questions
What is Gmail Search Emails?
Atomic node skill to search for emails in Gmail using the gog CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 60 downloads so far.
How do I install Gmail Search Emails?
Run "/install gmail-search-emails" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail Search Emails free?
Yes, Gmail Search Emails is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail Search Emails support?
Gmail Search Emails is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail Search Emails?
It is built and maintained by zvirb (@zvirb); the current version is v1.0.3.
More Skills