mail-client_skill

Overview

This skill is an IMAP/SMTP mail client for OpenClaw agents that provides read, search, move, mark, delete, and send capabilities for standard mail servers. It uses only the Python standard library and requires no external dependencies. The skill is designed for interactive agent workflows and small-scale automation, not for bulk mailing or providers that require OAuth.

How this skill works

The skill reads IMAP settings and SMTP credentials from a secured local secrets file and respects behavioral restrictions configured in a JSON file. It exposes a MailClient class with methods to list, read, search, move, mark, delete, and send messages, plus a CLI for the same operations. Setup includes an interactive wizard to collect host/port, user credentials, and capability toggles, and an init check to validate connectivity.

When to use it

• Check or summarize unread messages in an agent workflow
• Search a mailbox by sender, subject, date, or message text
• Send individual emails with plain text or HTML bodies
• Move messages to folders, mark read/unread, or delete single messages
• List IMAP folders or check mailbox quota during troubleshooting

Best practices

• Enable only the capabilities you need in config.json (least privilege)
• Use an application-specific password or app key rather than storing full account passwords
• Keep the secrets file permission-restricted (chmod 600) and out of version control
• Limit max_results to avoid large payloads in agent responses
• Avoid using this skill for bulk mail or newsletter sending

Example use cases

• Summarize unread messages each morning and surface senders + subjects
• Search for emails with subject containing 'invoice' and move them to an Archive/Invoices folder
• Send alert emails from a monitoring agent when a threshold is exceeded
• Mark a message read after an agent processes its contents
• List folders and quota to help diagnose mailbox issues