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

1. Enable 2-Factor Authentication on your Google Account:
• Go to https://myaccount.google.com/security

1. Generate an App Password:
• Go to https://myaccount.google.com/apppasswords
• Select "Mail" as the app
• Copy the 16-character password (no spaces)

1. Set environment variables:

export GMAIL_USER="your-email@gmail.com"
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 "recipient@example.com" "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 "admin@example.com" "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 "you@example.com" "Check Email" "Found important email"

Commands

Environment Variables

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