imap-smtp-email

• Automated inbox monitoring — poll for new or unread messages on a schedule and trigger workflows based on incoming mail.
• AI-powered email responses — let an agent read incoming emails and compose or send replies via SMTP.
• Multi-account management — manage personal, work, and other inboxes from a single configured skill instance.
• Attachment workflows — automatically download attachments from specific senders or subjects for further processing.

• Gmail-only users who prefer OAuth — this skill uses password/App Password authentication, not OAuth2 browser flows; if your organization enforces OAuth-only access, this skill won't work.
• Proprietary APIs (e.g., Microsoft Graph, Gmail REST API) — if you need advanced provider-specific features (labels, calendar integration, push notifications), a provider-specific skill would be a better fit.

Check for new/unread messages, fetch complete email content by UID, search by sender, subject, date range, or read/unread status, and mark messages as read or unread. List all available mailboxes and folders on the server.

Send plain-text or HTML emails to one or more recipients, with optional CC and BCC. Supports file attachments (comma-separated), body content from files, and sender override — all from a single command.

Download all attachments from a specific email by UID, or target a single file by name. Output directory is configurable, and file access is restricted by a whitelist for security.

Configure any number of named accounts using a prefix convention in a single .env file. Switch between accounts at runtime with --account <name> — no separate config files needed.

Pre-tested with Gmail, Outlook/Office 365, QQ Mail, exmail.qq.com, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, vip.188.com, and yeah.net. Works with any standard IMAP/SMTP server.

Credentials are stored at ~/.config/imap-smtp-email/.env with 600 permissions (owner read/write only). Configuration survives skill updates and falls back gracefully to a local .env for backward compatibility.

Schedule the agent to run check --recent 24h each morning, fetch full content for flagged messages, and summarize them — giving you a daily briefing without opening your inbox.

After generating a report file, the agent sends it via SMTP with --attach report.pdf to a distribution list, including CC and a formatted HTML body — no human hand-off required.

Search the inbox for unread messages from a support address, fetch their content, extract key details, and either route them to a ticketing system or send an acknowledgment reply automatically.

Configure a personal and a work account, then query both with --account personal and --account work to surface unread emails across all accounts in a single agent session.