Setup & Installation
openclaw skills install @junkaixue/gmail-tool
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install gmail-tool
What This Skill Does
CLI utility for sending and reading Gmail via SMTP and IMAP. Authenticates using a Gmail App Password, requiring 2FA on the account. Accepts plain-text commands for one-off sends or inbox checks.
Combining send and read in a single binary avoids managing two separate tools or setting up a mail library in each script.
When to use it
- Send server downtime alerts from a cron job
- Check inbox for important emails on a schedule
- Automate deployment notifications to a team address
- Monitor a shared inbox from the terminal
- Pipe script output directly into an email body
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: send an alert email when a backup script fails
AGENT
- 1Set GMAIL_USER and GMAIL_APP_PASSWORD environment variables
- 2Run the backup script and capture its exit code
- 3On non-zero exit, call ./gmail-tool send with recipient, subject, and error message
- 4Optionally schedule the check via cron
OUTPUT
An alert email lands in the recipient's inbox with the failure details
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
GMAIL_USER environment variable (Gmail address)GMAIL_APP_PASSWORD environment variable (16-character App Password from Google Account)Gmail account with 2-Factor Authentication enabled