pmax-email

name	pmax-email
description	Check inbox, summarize emails, read specific messages, reply, and send new emails for Performance MAX Agency. Use this skill when the user asks about their email, inbox, or wants to send/reply to messages.
version	1.0.0
author	Mousa Abu Mazin
license	MIT
platforms	["linux","macos"]
prerequisites	{"env_vars":["EMAIL_ADDRESS","EMAIL_PASSWORD","EMAIL_IMAP_HOST","EMAIL_SMTP_HOST"]}
metadata	{"hermes":{"tags":["email","inbox","imap","smtp","communication","agency"]}}

Performance MAX Email Manager

Manage the agency email inbox directly. Check for new messages, get summaries, read full emails, reply, and compose new ones.

Available Commands

All commands use the scripts/email_tool.py script.

Check Inbox (unread emails)

python3 scripts/email_tool.py inbox [--limit 20]

Returns a summary of unread emails: sender, subject, date, and first 200 chars of body.

Read a Specific Email

python3 scripts/email_tool.py read <email_uid>

Returns the full email body, sender, subject, date, and any attachment names.

Search Emails

python3 scripts/email_tool.py search "keyword" [--limit 10]

Searches subject and body for the keyword. Returns matching emails.

Reply to an Email

python3 scripts/email_tool.py reply <email_uid> "Your reply message here"

Sends a reply maintaining the email thread (proper In-Reply-To headers).

Send a New Email

python3 scripts/email_tool.py send "[e-mail]" "Subject line" "Email body here"

Sends a new email from the agency account.

Get Daily Summary

python3 scripts/email_tool.py summary [--hours 24]

Returns a categorized summary of emails from the last N hours:

• Urgent: client complaints, deadlines, payments
• Action Required: new leads, proposals, meeting requests
• FYI: newsletters, notifications, automated messages

Usage Guidelines

• When the user says "check my email" → run inbox
• When the user says "what's new" → run summary --hours 8
• When the user wants details on a specific email → run read <uid>
• When the user says "reply to that" → run reply <uid> "message"
• When the user says "email John about X" → run send
• Always show the draft before sending a reply — ask for confirmation
• Categorize emails by urgency when presenting summaries
• Keep summaries concise — sender, subject, one-line preview