Lightweight email manager with IMAP/SMTP support, advanced search, folder management, and attachment detection. Works with Zoho, Gmail, Outlook, and any IMAP/SMTP provider.
Lightweight email manager with IMAP/SMTP support, advanced search, folder management, and attachment detection. Works with Zoho, Gmail, Outlook, and any IMAP/SMTP provider.
Email Manager Lite v0.2
A fully self-contained email management skill for OpenClaw. Uses standard IMAP and SMTP protocols with zero external dependencies.
✨ What's New in v0.2
🔍 Advanced Search & Filters
Search by sender (--from)
Search by subject keywords (--subject)
Filter by date range (--since, --before)
Filter by read/unread status (--seen, --unseen)
Search in email body (--body, warning: can be slow)
📁 Folder Management
List all IMAP folders with folders command
Move emails between folders with move command
Automatic validation of folder existence
📎 Attachment Information
Automatic detection of attachments
Display attachment details:
Filename
MIME type
File size (formatted KB/MB)
Shown in both read and search results
🔧 Installation
cd skills/portable-email-manager
npm install
Dependencies are bundled in package.json:
nodemailer - SMTP email sending
imap-simple - IMAP operations
mailparser - Email parsing and attachment detection
# Search by sender and subject
./scripts/email.js search --from "client@example.com" --subject "proposal"# Search by date
./scripts/email.js search --since "Jan 20, 2026" --subject "meeting notes"
Archive Old Emails
# Find old read emails
./scripts/email.js search --before "Dec 1, 2025" --seen --limit 50
# Move each to Archive (use UID from output)
./scripts/email.js move <uid> "Archive"
Check for Attachments
# Read recent emails and see attachment info
./scripts/email.js read 10
# Search output automatically shows:# - Number of attachments# - Filename, type, and size for each
🔒 Security
Credentials never logged or stored in files
TLS/SSL encryption for all connections
App Passwords recommended over account passwords
No data leaves your machine except IMAP/SMTP connections
⚙️ Configuration
Default configuration is optimized for Zoho Mail EU.
