Simple Mail Client

SKILL.md

# 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.