generic-mail-client
A generic email client skill. Supports any mailbox using IMAP/POP3 + SMTP with username and password authentication:
- Alibaba Cloud Enterprise Mail
- QQ Mail / 163 / Gmail / Outlook / Exchange (with IMAP/POP3/SMTP enabled)
Capabilities
- Multi-account support — select mailbox via accountId
- Sending (SMTP):
- Plain text / HTML / Markdown body - Multiple recipients (To/Cc/Bcc) - Attachments (base64 transfer)
- Receiving (IMAP/POP3):
- List recent emails (by folder, date, unread status, keyword) - View email details (subject, body, attachment info) - Retrieve attachment content (optional) - Mark as read/unread, move emails (IMAP only)
Security Notes
- All mailbox credentials (host/port/username/password) are stored only in the host configuration and are not visible to the LLM.
- Logs do not record full email bodies or attachment content — only API call results, email IDs, timestamps, and other metadata.
- It is strongly recommended to use a dedicated bot email account or app-specific password. Do not use your personal login password.
- Default rate limits and list size caps are enforced to prevent misuse as a spam tool.
Configuration
See config.example.yaml. Copy it to config.yaml on the host side and inject it into the skill.