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.