mail-client
by romain-grosos
Web & Frontend DevelopmentBrief
IMAP/SMTP mail client for OpenClaw agents.
Description
What This Skill Does
IMAP/SMTP mail client for OpenClaw agents using Python stdlib with no external dependencies. Reads, searches, sends, moves, marks, and deletes messages on any standard mail server. Works with any provider that supports standard IMAP/SMTP, excluding OAuth-only providers.
Uses only Python stdlib with zero external dependencies, so it deploys in restricted environments without any package installation.
When to Use It
- Checking unread emails each morning
- Searching for emails by sender, subject, or date
- Sending automated alert emails from monitoring scripts
- Moving messages to archive folders by matching criteria
- Attaching files and reports to outbound emails
Example Workflow
User asks: Find all unread emails about invoices and move them to Archive/Invoices
- 1
Connects to IMAP server using stored credentials
- 2
Searches for unread messages with 'invoice' in the subject
- 3
Lists matching messages with UIDs, senders, and subjects
- 4
Moves each matching message to the Archive/Invoices folder
Confirmation that matching invoice emails were moved to Archive/Invoices
Requirements
- MAIL_USER environment variable (your email address)
- MAIL_APP_KEY environment variable (application password generated from your mail provider's account settings)
- MAIL_SMTP_HOST environment variable
- MAIL_IMAP_HOST environment variable
Installation
clawhub install romain-grosos/mail-clientRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.