email-suite

Email CLI: node scripts/mail.js . Works with Gmail, Outlook, Hostinger, any IMAP/SMTP server.

Setup

Automated (recommended)

bash setup.sh

Runs: Node.js check → npm install → provider menu → credentials → display name → signature → summary → connection test

Manual

npm install
cp env.example.txt .env   # Edit with your credentials

.env Configuration

Required

# IMAP (receiving)
IMAP_HOST=imap.gmail.com
IMAP_PORT=993
IMAP_USER=your@email.com
IMAP_PASS=your_app_password

# SMTP (sending)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false          # true for port 465, false for 587
SMTP_USER=your@email.com
SMTP_PASS=your_app_password

Optional

SMTP_FROM=your@email.com  # Default sender
FROM_NAME="Your Name"      # Display name shown to recipients
IMAP_REJECT_UNAUTHORIZED=false  # For self-signed certs
SMTP_REJECT_UNAUTHORIZED=false  # For self-signed certs

Provider Presets

Gmail/Outlook: Use App Password

Not your regular password — generate a 16-char App Password:

• Gmail: myaccount.google.com/apppasswords
• Outlook: Account → Security → App passwords

Essential Commands

Flags

• --all — All messages (read + unread, combined chronological)
• --limit N — Limit results
• --since 7d — Time filter (7d, 1m, YYYY-MM-DD)
• --before YYYY-MM-DD — Before date

Multi-ID

delete <uid1> <uid2>   # Delete multiple
mark-read <uid1> <uid2> # Mark multiple read

Send Options

• --body-file x.md — Markdown auto-converted to HTML
• --attach file.pdf — Attachments
• reply --body "T" — Reply (auto Re: prefix)
• forward --to x — Forward

Cache

• .cache/inbox.json — Local cache for fast checks
• sync = incremental (new msgs only)
• fetch = always server, marks read, updates cache
• delete / clear-cache = clears cache

Security

• Never commit .env to git
• chmod 600 .env to protect credentials
• Use App Passwords for Gmail/Outlook (2FA required)