gmail-tool
by junkaixue
DevOps & CloudBrief
Send and read emails via Gmail using App Password.
Description
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
User asks: send an alert email when a backup script fails
- 1
Set GMAIL_USER and GMAIL_APP_PASSWORD environment variables
- 2
Run the backup script and capture its exit code
- 3
On non-zero exit, call ./gmail-tool send with recipient, subject, and error message
- 4
Optionally schedule the check via cron
An alert email lands in the recipient's inbox with the failure details
Requirements
- 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
Installation
clawhub install junkaixue/gmail-toolRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.