ariffazil/gmail

Gmail Email Skill

Trigger

Any task involving email — read inbox, send message, search emails, check unread.

Credentials

Stored in: /root/AAA/secrets/email.env (mode 600) Also available as env vars: GMAIL_USER, GMAIL_APP_PASSWORD

IMAP (Read)

import imaplib, email, os
from email.header import decode_header

user = os.environ.get("GMAIL_USER", "[email protected]")
password = os.environ.get("GMAIL_APP_PASSWORD", "")

mail = imaplib.IMAP4_SSL("imap.gmail.com")
mail.login(user, password)
mail.select("INBOX")

# Fetch last 10 emails
_, msgs = mail.search(None, "ALL")
ids = msgs[0].split()
for uid in ids[-10:]:
    _, data = mail.fetch(uid, "(RFC822)")
    msg = email.message_from_bytes(data[0][1])
    subject = msg["Subject"]
    sender = msg["From"]
    date = msg["Date"]
    print(f"{date} | {sender} | {subject}")

mail.logout()

SMTP (Send)

import smtplib, os
from email.message import EmailMessage

user = os.environ.get("GMAIL_USER", "[email protected]")
password = os.environ.get("GMAIL_APP_PASSWORD", "")

msg = EmailMessage()
msg["From"] = user
msg["To"] = "[email protected]"
msg["Subject"] = "Subject here"
msg.set_content("Body text here")

with smtplib.SMTP("smtp.gmail.com", 587) as server:
    server.starttls()
    server.login(user, password)
    server.send_message(msg)

Search Inbox

# Unread only
mail.select("INBOX")
_, msgs = mail.search(None, "UNSEEN")

# Search by subject
_, msgs = mail.search(None, 'SUBJECT "keyword"')

# Search by sender
_, msgs = mail.search(None, 'FROM "[email protected]"')

Actions

• Read inbox → fetch N recent emails, show sender/subject/date
• Send email → compose and send via SMTP
• Search → search by sender, subject, keyword
• Unread count → report unread email count
• Mark read → mark specific email as read

From address

All outgoing emails show From: [email protected] — no alias support via IMAP/SMTP. If you need to send from [email protected], requires Cloudflare/Resend API instead.