← Back to Skills Marketplace
aiwithabidi

Gmail Ai

by aiwithabidi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
411
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gmail-ai
Description
AI-enhanced Gmail — smart email triage, priority scoring, AI-generated replies, thread summarization, and automated categorization. IMAP/SMTP with OpenRouter...
README (SKILL.md)

📧 Gmail AI

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 "[email protected]"

# 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 \x3Cmessage_id>

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

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

# Send with CC/BCC
python3 {baseDir}/scripts/gmail_ai.py send --to "[email protected]" --cc "[email protected]" --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 \x3Cmessage_id>

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

reply \x3Cmessage_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

Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: gmail-ai Version: 1.0.0 The skill is classified as suspicious due to a potential LLM prompt injection vulnerability in `scripts/gmail_ai.py`. Email content (subject, body, sender) is directly incorporated into prompts sent to the `openrouter.ai` LLM without explicit sanitization. This could allow a malicious actor to craft emails that manipulate the LLM's behavior, potentially leading to unintended disclosures or actions by the AI agent. While this is a significant vulnerability, there is no clear evidence of intentional malicious behavior such as unauthorized data exfiltration, backdoors, or persistence mechanisms; the external communication to `openrouter.ai` and Gmail is for the skill's stated purpose.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gmail-ai
  3. After installation, invoke the skill by name or use /gmail-ai
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of gmail-ai — AI-powered Gmail management. - Adds AI triage to auto-categorize emails (urgent, actionable, FYI, spam) - Introduces priority scoring for emails (0–100 scale) - Enables AI-generated smart replies in multiple tones - Provides TL;DR thread summarization - Supports composing and sending emails via SMTP - Requires Gmail App Password for IMAP/SMTP access; OpenRouter API key is optional for AI features
Metadata
Slug gmail-ai
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Gmail Ai?

AI-enhanced Gmail — smart email triage, priority scoring, AI-generated replies, thread summarization, and automated categorization. IMAP/SMTP with OpenRouter... It is an AI Agent Skill for Claude Code / OpenClaw, with 411 downloads so far.

How do I install Gmail Ai?

Run "/install gmail-ai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gmail Ai free?

Yes, Gmail Ai is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Gmail Ai support?

Gmail Ai is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gmail Ai?

It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments