Gmail Ai

AI-enhanced Gmail — smart email triage, priority scoring, AI-generated replies, thread summarization, and automated categorization. IMAP/SMTP with OpenRouter...

Security Scan

The skill's code and instructions match its stated purpose (IMAP/SMTP mailbox access and optional OpenRouter-powered AI features), but there are minor metadata mismatches and expected sensitive-data exposures you should be aware of before installing.

Purpose & Capability

The skill declares Gmail AI features (triage, summarization, replies, send) and the included script uses imaplib/smtplib and the OpenRouter API — these are coherent with the stated purpose. No unrelated services or credentials are requested beyond Gmail and an optional OpenRouter key.

Instruction Scope

SKILL.md and the script instruct the agent to read mailbox contents via IMAP, compose/send mail via SMTP, and (when OPENROUTER_API_KEY is set) send email content to openrouter.ai for LLM processing. This external transmission of email content is expected for AI features but is an important privacy/third-party-exfiltration consideration. Also note some small inconsistencies: SKILL.md shows GMAIL_ADDRESS as required and OPENROUTER_API_KEY as optional for AI features; the script will exit if OPENROUTER_API_KEY is missing when an AI command is used.

Install Mechanism

Instruction-only install (no install spec) and a single Python script are included. No downloads from untrusted URLs or archive extraction are performed. This is low-risk from an installation-execution perspective, though running the script will execute code on the agent host.

Credentials

The registry metadata lists only GMAIL_APP_PASSWORD as required, but the script also requires GMAIL_ADDRESS (and uses OPENROUTER_API_KEY for AI features). These env vars are proportional to the functionality, but GMAIL_APP_PASSWORD grants full mailbox access and is highly sensitive. OPENROUTER_API_KEY causes email content to be sent to a third-party API; that should be considered before providing the key.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system-wide settings, and is user-invocable. It does not request persistent platform privileges beyond normal execution of an included script.

Assessment

This skill appears to do what it says: it logs into your Gmail via IMAP/SMTP and (optionally) sends email content to OpenRouter for AI triage/replies. Before installing: (1) understand that GMAIL_APP_PASSWORD is required and grants full access to the mailbox—treat it like a secret and consider using a dedicated account or rotating the app password. (2) If you enable AI features, your email content will be sent to openrouter.ai (provide OPENROUTER_API_KEY only if you accept that). (3) The registry metadata omits GMAIL_ADDRESS (and marks only GMAIL_APP_PASSWORD as required) — make sure you set GMAIL_ADDRESS in the environment. (4) Prefer auditing the included script yourself before running it in production; consider running it with limited test mailboxes first. (5) If you want less exposure to third parties, consider an OAuth-based connector instead of an App Password + external LLM API.

AI-enhanced Gmail for OpenClaw agents. Fork of gmail v1.0.6 with AI triage, priority scoring, smart replies, and email summarization.

What's New vs gmail

• AI triage — auto-categorize emails (urgent/actionable/FYI/spam)
• Priority scoring — 0-100 score based on sender, subject, content
• Smart replies — context-aware reply generation in multiple tones
• Email summarization — TL;DR for long threads
• Send email — compose and send via SMTP

Requirements

Variable	Required	Description
GMAIL_ADDRESS	✅	Your Gmail address
GMAIL_APP_PASSWORD	✅	Gmail App Password (create one)
OPENROUTER_API_KEY	Optional	For AI triage, replies, and summaries

Quick Start

# Fetch recent unread emails
python3 {baseDir}/scripts/gmail_ai.py inbox --unread --limit 10

# Fetch by label
python3 {baseDir}/scripts/gmail_ai.py inbox --label INBOX --limit 20

# Fetch from specific sender
python3 {baseDir}/scripts/gmail_ai.py inbox --from "[e-mail]"

# AI triage — categorize emails
python3 {baseDir}/scripts/gmail_ai.py triage --limit 20

# Priority scoring
python3 {baseDir}/scripts/gmail_ai.py priority --limit 20

# Summarize an email thread
python3 {baseDir}/scripts/gmail_ai.py summarize <message_id>

# Generate smart reply
python3 {baseDir}/scripts/gmail_ai.py reply <message_id> --tone professional
python3 {baseDir}/scripts/gmail_ai.py reply <message_id> --tone friendly
python3 {baseDir}/scripts/gmail_ai.py reply <message_id> --tone brief

# Send email
python3 {baseDir}/scripts/gmail_ai.py send --to "[e-mail]" --subject "Hello" --body "Message body"

# Send with CC/BCC
python3 {baseDir}/scripts/gmail_ai.py send --to "[e-mail]" --cc "[e-mail]" --subject "Hello" --body "Message"

Commands

inbox

Fetch emails from Gmail via IMAP.

• --unread — only unread messages
• --label LABEL — Gmail label/folder (default: INBOX)
• --from ADDRESS — filter by sender
• --limit N — max results (default: 10)
• --since YYYY-MM-DD — emails since date

triage

AI-powered email categorization (requires OPENROUTER_API_KEY).

• Categories: 🔴 Urgent, 🟡 Actionable, 🔵 FYI, ⚪ Spam/Noise
• --limit N — number of emails to triage

priority

Score emails 0-100 based on sender importance, subject urgency, and content.

• --limit N — number of emails to score
• Factors: known sender, urgency keywords, mentions of you, deadlines

summarize <message_id>

Generate a TL;DR summary of an email or thread.

reply <message_id>

Generate a context-aware reply draft.

• --tone professional|friendly|brief|formal — reply style
• --context TEXT — additional context for the reply

send

Send email via SMTP.

• --to ADDRESS — recipient (required)
• --subject TEXT — subject line (required)
• --body TEXT — email body (required)
• --cc ADDRESS — CC recipient
• --bcc ADDRESS — BCC recipient

Security Notes

• Uses Gmail App Passwords (not OAuth) — simpler setup, works with 2FA
• App Password is NOT your Google password
• Create one at: Google Account → Security → 2-Step Verification → App Passwords
• IMAP must be enabled in Gmail settings

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation