leifengzhou/alibaba-mail

Alibaba Mail Skill

Send and receive emails via Alibaba Cloud DirectMail SMTP + IMAP.

Credentials

Store in /home/neo/.secrets/alibaba_mail.json:

{
  "email": "[email protected]",
  "password": "your-password",
  "sender_name": "Your Display Name",
  "smtp": {
    "server": "smtpdm-ap-southeast-1.aliyun.com",
    "port": 465,
    "use_tls": true
  },
  "imap": {
    "server": "imap.your-provider.com",
    "port": 993,
    "use_ssl": true
  }
}

| Field | Required | Description | |-------|----------|-------------| | email | Yes | Your Alibaba Cloud DirectMail address | | password | Yes | Shared password for SMTP and IMAP | | sender_name | No | Display name in "From" field | | imap.server | Yes | IMAP server (e.g., imap.gmail.com) | | imap.port | Yes | IMAP port (usually 993) |

Usage

Send Email

Neo, send an email to [email protected] with subject "Hello" and body "Test message"

Send Bulk Emails

Neo, send bulk emails to recipients.json with subject "Newsletter" and body "Your content"
Neo, send bulk emails to recipients.json with subject "Update" --html-file template.html

Check Inbox

Neo, check my inbox for new emails
Neo, how many unread emails do I have?
Neo, show me recent emails from today

Rich HTML Emails

For professional newsletters, use --html-file to load content from an HTML file:

python3 send_bulk.py recipients.json "Newsletter" --html-file newsletter.html

Sample HTML template available: newsletter.html.sample

Scripts

| Script | Description | |--------|-------------| | send_email.py | Send a single email | | send_bulk.py | Send bulk emails to a list | | check_inbox.py | Check inbox for recent/unread emails |

Recipients File Format (recipients.json)

[
  {"email": "[email protected]", "name": "John"},
  {"email": "[email protected]", "name": "Jane"},
  {"email": "[email protected]"}
]

Features

• SMTP: Send emails via Alibaba Cloud DirectMail
• IMAP: Check and read emails from any IMAP server
• Auto SMTP server selection based on email domain
• SSL encryption on port 465 (SMTP) and 993 (IMAP)
• Rate limiting for bulk sends (1 email per second)
• Progress tracking for bulk operations
• Error handling with detailed messages

Limits

• SMTP: 2,000 emails/day (Alibaba Cloud DirectMail quota)
• IMAP: Depends on your email provider
• Recommended: 1-2 second delay between bulk sends

IMAP Providers

| Provider | IMAP Server | Notes | |----------|--------------|-------| | Gmail | imap.gmail.com | Requires App Password if 2FA enabled | | Outlook | imap.outlook.com | Microsoft 365 account | | Yahoo | imap.mail.yahoo.com | Requires App Password | | Custom Domain | mail.yourdomain.com | Check your hosting provider |