A lightweight CLI utility for sending and reading Gmail messages using secure App Passwords.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gmail-tool
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gmail-tool using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Gmail Tool?
The Gmail Tool is a robust command-line interface designed to streamline email interactions for developers and automated systems. As part of the ecosystem of Openclaw Skills, this tool provides a bridge between your local environment and Gmail's infrastructure, allowing for seamless integration of email capabilities into any workflow. It simplifies the complexities of SMTP and IMAP protocols, offering a unified command set for managing communications.
By utilizing this skill, users can programmatically send alerts, monitor incoming messages, and create automated response systems. It is built with a focus on simplicity and security, ensuring that your automated processes remain reliable while adhering to modern authentication standards like Google App Passwords.
Gmail Tool Use Cases
- Send automated system alerts and notifications to administrators.
- Monitor your inbox for specific keywords or triggers using Openclaw Skills.
- Integrate email capabilities into daily cron jobs for automated reporting.
- Build custom notification bridges for AI agent workflows.
How Gmail Tool Works
- The tool initializes a secure connection to Gmail using provided environment credentials.
- For outgoing messages, it utilizes the SMTP protocol to transmit subjects and body text to specified recipients.
- For incoming queries, it establishes an IMAP connection to fetch and parse the most recent messages in the inbox.
- Users interact with the tool via simple CLI commands, specifying parameters like recipient addresses or the number of emails to retrieve.
- The integration with Openclaw Skills ensures the process is optimized for agentic workflows and automation.
Gmail Tool Setup
To get started, first enable 2-Factor Authentication on your Google Account and generate a 16-character App Password. Configure your environment variables as follows:
export GMAIL_USER="[email protected]"
export GMAIL_APP_PASSWORD="xxxxxxxxxxxxxxxx"
Install the tool using ClawHub or by copying it to your local directory:
clawhub install gmail-tool
Gmail Tool Data Schema & Taxonomy
The Gmail Tool primarily processes transient email data and relies on environment-based configuration for security. Below is the metadata taxonomy used by the skill:
| Attribute | Type | Description |
|---|---|---|
| GMAIL_USER | String | The Gmail address used for authentication. |
| GMAIL_APP_PASSWORD | String | Secure 16-character token for app access. |
| Command Type | Enum | Defines action: send or read. |
| Read Count | Integer | The number of recent messages to fetch from the server. |
Gmail Tool Advanced Features
- Support for complex piping, allowing outputs to be filtered by tools like grep within Openclaw Skills.
- Headless operation suitable for server environments and CI/CD pipelines.
- Automated alert escalation via cron job integration.
- Secure credential management that prevents hardcoding sensitive information in scripts.
SKILL.md
Loading
Related Openclaw Skills
Gmail Sender Skill
A lightweight CLI utility for sending automated emails via Gmail SMTP using Google App Passwords.
SAAS Worker
A high-velocity AI skill designed to help developers build, launch, and scale SAAS products to $1000+ MRR with a focus on revenue over perfection.
SaaS Revenue Tracker
A specialized analytics skill for tracking Monthly Recurring Revenue (MRR), churn rates, and overall SaaS profitability benchmarks.
SAAS Orchestrator
A command center for building and managing a portfolio of profitable SAAS products using automated AI subagents.
Cloudflare R2 Management
A high-performance command-line interface for managing Cloudflare R2 storage buckets and object lifecycles using rclone.
What to Eat - AI Meal Recommender
End daily meal indecision with intelligent, context-aware food recommendations tailored to your cravings and budget.
Featured*
