Gmail Tool

Send and read Gmail messages via CLI using App Password, supporting SMTP for sending and IMAP for reading emails.

Audits

Pending

ClawScanPass

Agentic behavior and permission review.

Static analysisPending

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install gmail-tool

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:
- Go to https://myaccount.google.com/security
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="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

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