Gmail Tool OpenClaw Plugin & Skill | ClawHub
Looking to integrate Gmail Tool into your AI workflows? This free OpenClaw plugin from ClawHub helps you automate devops & cloud tasks instantly, without having to write custom tools from scratch.
What this skill does
Send and read emails via Gmail using App Password.
Install
ClawHub CLI
openclaw skills install @junkaixue/gmail-toolNode.js (npx)
npx clawhub@latest install gmail-toolFull SKILL.md
Open originalSKILL.md content below is scrollable.
Gmail Tool
Send and read emails via Gmail using App Password. CLI utility for automated alerts, notifications, and email monitoring.
Overview
A CLI tool to send and read emails through Gmail. Combines SMTP (send) and IMAP (read) in one utility.
Requirements
- Python 3.6+
- Gmail account with App Password enabled
Setup
-
Enable 2-Factor Authentication on your Google Account:
-
Generate an App Password:
- Go to https://myaccount.google.com/apppasswords
- Select "Mail" as the app
- Copy the 16-character password (no spaces)
-
Set environment variables:
export GMAIL_USER="[email protected]"
export GMAIL_APP_PASSWORD="xxxxxxxxxxxxxxxx"
Installation
# Clone or copy to skills directory
cp -r gmail-tool ~/.openclaw/workspace/skills/
# Or use ClawHub
clawhub install gmail-tool
Usage
Send Email
chmod +x gmail-tool
./gmail-tool send "[email protected]" "Subject" "Body text"
Read Emails
# Read last 5 emails
./gmail-tool read
# Read last 10 emails
./gmail-tool read 10
Examples
# Send notification
./gmail-tool send "[email protected]" "Alert" "Server down!"
# Check inbox
./gmail-tool read 3
# Cron job - check and alert
0 9 * * 1-5 ./gmail-tool read 1 | grep -q "Important" && ./gmail-tool send "[email protected]" "Check Email" "Found important email"
Commands
| Command | Usage |
|---|---|
send <to> <subject> <body> |
Send an email |
read [count] |
Read last N emails (default: 5) |
Environment Variables
| Variable | Required | Description |
|---|---|---|
| GMAIL_USER | Yes | Your Gmail address |
| GMAIL_APP_PASSWORD | Yes | 16-char App Password |
Security Notes
- Never commit App Passwords to version control
- Use environment variables, never hardcode credentials
- App Passwords are 16 characters (no spaces)
- Revoke app passwords if compromised
Troubleshooting
Send failed: "535 5.7.8 Username and Password not accepted"
- Verify App Password is correct
- Make sure 2FA is enabled
Read failed: "Too many simultaneous connections"
- Gmail limits IMAP connections. Wait and retry.
License
MIT
Author
junkaixue
ClawHub Registry URL: https://clawhub.ai/junkaixue/skills/gmail-tool