Install
Terminal · npx$
npx skills add https://github.com/boomsystel-code/openclaw-workspace --skill imap-smtp-emailWorks with Paperclip
How Imap Smtp Email fits into a Paperclip company.
Imap Smtp Email drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.
S
SaaS FactoryPaired
Pre-configured AI company — 18 agents, 18 skills, one-time purchase.
$27$59
Explore packSource file
SKILL.md190 linesExpandCollapse
---name: imap-smtp-emaildescription: Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes, mark as read/unread, and send emails with attachments. Works with any IMAP/SMTP server including Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, and vip.188.com.--- # IMAP/SMTP Email Tool Read, search, and manage email via IMAP protocol. Send email via SMTP. Supports Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, vip.188.com, and any standard IMAP/SMTP server. ## Configuration Create `.env` in the skill folder or set environment variables: ```bash# IMAP Configuration (receiving email)IMAP_HOST=imap.gmail.com # Server hostnameIMAP_PORT=993 # Server portIMAP_USER=your@email.comIMAP_PASS=your_passwordIMAP_TLS=true # Use TLS/SSL connectionIMAP_REJECT_UNAUTHORIZED=true # Set to false for self-signed certsIMAP_MAILBOX=INBOX # Default mailbox # SMTP Configuration (sending email)SMTP_HOST=smtp.gmail.com # SMTP server hostnameSMTP_PORT=587 # SMTP port (587 for STARTTLS, 465 for SSL)SMTP_SECURE=false # true for SSL (465), false for STARTTLS (587)SMTP_USER=your@gmail.com # Your email addressSMTP_PASS=your_password # Your password or app passwordSMTP_FROM=your@gmail.com # Default sender email (optional)SMTP_REJECT_UNAUTHORIZED=true # Set to false for self-signed certs``` ## Common Email Servers | Provider | IMAP Host | IMAP Port | SMTP Host | SMTP Port ||----------|-----------|-----------|-----------|-----------|| 163.com | imap.163.com | 993 | smtp.163.com | 465 || vip.163.com | imap.vip.163.com | 993 | smtp.vip.163.com | 465 || 126.com | imap.126.com | 993 | smtp.126.com | 465 || vip.126.com | imap.vip.126.com | 993 | smtp.vip.126.com | 465 || 188.com | imap.188.com | 993 | smtp.188.com | 465 || vip.188.com | imap.vip.188.com | 993 | smtp.vip.188.com | 465 || yeah.net | imap.yeah.net | 993 | smtp.yeah.net | 465 || Gmail | imap.gmail.com | 993 | smtp.gmail.com | 587 || Outlook | outlook.office365.com | 993 | smtp.office365.com | 587 || QQ Mail | imap.qq.com | 993 | smtp.qq.com | 587 | **Important for 163.com:**- Use **authorization code** (授权码), not account password- Enable IMAP/SMTP in web settings first ## IMAP Commands (Receiving Email) ### checkCheck for new/unread emails. ```bashnode scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]``` Options:- `--limit <n>`: Max results (default: 10)- `--mailbox <name>`: Mailbox to check (default: INBOX)- `--recent <time>`: Only show emails from last X time (e.g., 30m, 2h, 7d) ### fetchFetch full email content by UID. ```bashnode scripts/imap.js fetch <uid> [--mailbox INBOX]``` ### downloadDownload all attachments from an email, or a specific attachment. ```bashnode scripts/imap.js download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>]``` Options:- `--mailbox <name>`: Mailbox (default: INBOX)- `--dir <path>`: Output directory (default: current directory)- `--file <filename>`: Download only the specified attachment (default: download all) ### searchSearch emails with filters. ```bashnode scripts/imap.js search [options] Options: --unseen Only unread messages --seen Only read messages --from <email> From address contains --subject <text> Subject contains --recent <time> From last X time (e.g., 30m, 2h, 7d) --since <date> After date (YYYY-MM-DD) --before <date> Before date (YYYY-MM-DD) --limit <n> Max results (default: 20) --mailbox <name> Mailbox to search (default: INBOX)``` ### mark-read / mark-unreadMark message(s) as read or unread. ```bashnode scripts/imap.js mark-read <uid> [uid2 uid3...]node scripts/imap.js mark-unread <uid> [uid2 uid3...]``` ### list-mailboxesList all available mailboxes/folders. ```bashnode scripts/imap.js list-mailboxes``` ## SMTP Commands (Sending Email) ### sendSend email via SMTP. ```bashnode scripts/smtp.js send --to <email> --subject <text> [options]``` **Required:**- `--to <email>`: Recipient (comma-separated for multiple)- `--subject <text>`: Email subject, or `--subject-file <file>` **Optional:**- `--body <text>`: Plain text body- `--html`: Send body as HTML- `--body-file <file>`: Read body from file- `--html-file <file>`: Read HTML from file- `--cc <email>`: CC recipients- `--bcc <email>`: BCC recipients- `--attach <file>`: Attachments (comma-separated)- `--from <email>`: Override default sender **Examples:**```bash# Simple text emailnode scripts/smtp.js send --to recipient@example.com --subject "Hello" --body "World" # HTML emailnode scripts/smtp.js send --to recipient@example.com --subject "Newsletter" --html --body "<h1>Welcome</h1>" # Email with attachmentnode scripts/smtp.js send --to recipient@example.com --subject "Report" --body "Please find attached" --attach report.pdf # Multiple recipientsnode scripts/smtp.js send --to "a@example.com,b@example.com" --cc "c@example.com" --subject "Update" --body "Team update"``` ### testTest SMTP connection by sending a test email to yourself. ```bashnode scripts/smtp.js test``` ## Dependencies ```bashnpm install``` ## Security Notes - Store credentials in `.env` (add to `.gitignore`)- For Gmail: use App Password if 2FA is enabled- For 163.com: use authorization code (授权码), not account password ## Troubleshooting **Connection timeout:**- Verify server is running and accessible- Check host/port configuration **Authentication failed:**- Verify username (usually full email address)- Check password is correct- For 163.com: use authorization code, not account password- For Gmail: use App Password if 2FA enabled **TLS/SSL errors:**- Match `IMAP_TLS`/`SMTP_SECURE` setting to server requirements- For self-signed certs: set `IMAP_REJECT_UNAUTHORIZED=false` or `SMTP_REJECT_UNAUTHORIZED=false`Related skills
1password
Install 1password skill for Claude Code from steipete/clawdis.
3d Web Experience
Install 3d Web Experience skill for Claude Code from sickn33/antigravity-awesome-skills.
Ab Test Setup
This handles the full A/B testing workflow from hypothesis formation to statistical analysis. It walks you through proper test design, calculates sample sizes,