email-manager-lite_skill

Overview

This skill is a lightweight, self-contained email manager that uses standard IMAP and SMTP protocols to read, send, search, and organize messages. It supports Zoho, Gmail, Outlook, iCloud and any IMAP/SMTP provider and provides attachment detection and folder management without external dependencies. Ideal for CLI-driven mail triage, automated workflows, and local archival.

How this skill works

The tool connects to your mail provider via IMAP for reading and folder operations and uses SMTP for sending messages. Commands let you list folders, read recent emails, run advanced server-side searches with filters (sender, subject, date, seen/unseen) and move messages by UID. Attachments are parsed and reported with filename, MIME type, and human-friendly size.

When to use it

• Daily inbox triage from the command line or scripts
• Automating archival or folder organization using saved UIDs
• Searching for emails with precise filters across date ranges and senders
• Checking messages for attachments and extracting metadata
• Using a lightweight mail client where no GUI or heavy deps are desired

Best practices

• Use provider app passwords (Gmail/Outlook/Zoho) rather than account passwords
• Run subject/from/date filters first to avoid slow body searches
• Limit results with --limit when scanning large mailboxes
• Call folders before moving mail to confirm exact folder names (case-sensitive)
• Store UIDs if automating moves or batch actions to avoid ambiguous selection

Example use cases

• Triage unread mail: search --unseen --limit 10 then move selected UIDs to folders
• Find a client message: search --from "client@example.com" --subject "proposal"
• Archive old read messages: search --before "Dec 1, 2025" --seen --limit 50 then move to Archive
• Verify attachments on recent mails: read 10 and review attachment filename/type/size
• Send a quick report: ./scripts/email.js send "boss@company.com" "Weekly Report" "Summary..."