← Back to Skills Marketplace
IMAP SMTP Email
by
welderjustin
· GitHub ↗
· v0.0.11
· MIT-0
430
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install welderjustin-imap-smtp-email
Description
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. Wor...
README (SKILL.md)
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:
# IMAP Configuration (receiving email)
IMAP_HOST=imap.gmail.com # Server hostname
IMAP_PORT=993 # Server port
[email protected]
IMAP_PASS=your_password
IMAP_TLS=true # Use TLS/SSL connection
IMAP_REJECT_UNAUTHORIZED=true # Set to false for self-signed certs
IMAP_MAILBOX=INBOX # Default mailbox
# SMTP Configuration (sending email)
SMTP_HOST=smtp.gmail.com # SMTP server hostname
SMTP_PORT=587 # SMTP port (587 for STARTTLS, 465 for SSL)
SMTP_SECURE=false # true for SSL (465), false for STARTTLS (587)
[email protected] # Your email address
SMTP_PASS=your_password # Your password or app password
[email protected] # 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 Gmail:
- Gmail does not accept your regular account password
- You must generate an App Password: https://myaccount.google.com/apppasswords
- Use the generated 16-character App Password as
IMAP_PASS/SMTP_PASS - Requires Google Account with 2-Step Verification enabled
Important for 163.com:
- Use authorization code (授权码), not account password
- Enable IMAP/SMTP in web settings first
IMAP Commands (Receiving Email)
check
Check for new/unread emails.
node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]
Options:
--limit \x3Cn>: Max results (default: 10)--mailbox \x3Cname>: Mailbox to check (default: INBOX)--recent \x3Ctime>: Only show emails from last X time (e.g., 30m, 2h, 7d)
fetch
Fetch full email content by UID.
node scripts/imap.js fetch \x3Cuid> [--mailbox INBOX]
download
Download all attachments from an email, or a specific attachment.
node scripts/imap.js download \x3Cuid> [--mailbox INBOX] [--dir \x3Cpath>] [--file \x3Cfilename>]
Options:
--mailbox \x3Cname>: Mailbox (default: INBOX)--dir \x3Cpath>: Output directory (default: current directory)--file \x3Cfilename>: Download only the specified attachment (default: download all)
search
Search emails with filters.
node scripts/imap.js search [options]
Options:
--unseen Only unread messages
--seen Only read messages
--from \x3Cemail> From address contains
--subject \x3Ctext> Subject contains
--recent \x3Ctime> From last X time (e.g., 30m, 2h, 7d)
--since \x3Cdate> After date (YYYY-MM-DD)
--before \x3Cdate> Before date (YYYY-MM-DD)
--limit \x3Cn> Max results (default: 20)
--mailbox \x3Cname> Mailbox to search (default: INBOX)
mark-read / mark-unread
Mark message(s) as read or unread.
node scripts/imap.js mark-read \x3Cuid> [uid2 uid3...]
node scripts/imap.js mark-unread \x3Cuid> [uid2 uid3...]
list-mailboxes
List all available mailboxes/folders.
node scripts/imap.js list-mailboxes
SMTP Commands (Sending Email)
send
Send email via SMTP.
node scripts/smtp.js send --to \x3Cemail> --subject \x3Ctext> [options]
Required:
--to \x3Cemail>: Recipient (comma-separated for multiple)--subject \x3Ctext>: Email subject, or--subject-file \x3Cfile>
Optional:
--body \x3Ctext>: Plain text body--html: Send body as HTML--body-file \x3Cfile>: Read body from file--html-file \x3Cfile>: Read HTML from file--cc \x3Cemail>: CC recipients--bcc \x3Cemail>: BCC recipients--attach \x3Cfile>: Attachments (comma-separated)--from \x3Cemail>: Override default sender
Examples:
# Simple text email
node scripts/smtp.js send --to [email protected] --subject "Hello" --body "World"
# HTML email
node scripts/smtp.js send --to [email protected] --subject "Newsletter" --html --body "\x3Ch1>Welcome\x3C/h1>"
# Email with attachment
node scripts/smtp.js send --to [email protected] --subject "Report" --body "Please find attached" --attach report.pdf
# Multiple recipients
node scripts/smtp.js send --to "[email protected],[email protected]" --cc "[email protected]" --subject "Update" --body "Team update"
test
Test SMTP connection by sending a test email to yourself.
node scripts/smtp.js test
Dependencies
npm install
Security Notes
- Store credentials in
.env(add to.gitignore) - Gmail: regular password is rejected — generate an App Password at https://myaccount.google.com/apppasswords
- 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: regular password won't work — generate an App Password at https://myaccount.google.com/apppasswords
TLS/SSL errors:
- Match
IMAP_TLS/SMTP_SECUREsetting to server requirements - For self-signed certs: set
IMAP_REJECT_UNAUTHORIZED=falseorSMTP_REJECT_UNAUTHORIZED=false
Usage Guidance
This skill appears to implement exactly what it claims: reading, searching, managing mail over IMAP and sending via SMTP. Before installing: (1) Be prepared to provide IMAP/SMTP credentials — use app-specific passwords (e.g., Gmail App Password) or authorization tokens rather than your primary account password. (2) The code requires ALLOWED_READ_DIRS and ALLOWED_WRITE_DIRS in .env to allow file reads/writes; add these to your .env and restrict them to the minimal directories you need. (3) setup.sh will create a .env containing your credentials, set chmod 600, test the IMAP connection and send a test SMTP email to your own address — expect network activity during setup. (4) Run npm install in a safe environment and review package.json if you require stricter dependency vetting. (5) If you need higher assurance, inspect the scripts locally (they are included) to verify there are no external endpoints beyond your mail servers and to confirm ALLOWED_* behavior meets your security requirements.
Capability Analysis
Type: OpenClaw Skill
Name: welderjustin-imap-smtp-email
Version: 0.0.11
The skill bundle provides legitimate functionality for managing emails via IMAP and SMTP protocols. It includes robust security features such as path whitelisting for file operations (ALLOWED_READ_DIRS and ALLOWED_WRITE_DIRS) and proper credential handling via a setup script that restricts file permissions. No evidence of malicious intent, data exfiltration, or prompt injection was found in scripts/imap.js, scripts/smtp.js, or SKILL.md.
Capability Assessment
Purpose & Capability
Name/description, CLI scripts (imap.js, smtp.js), package.json deps (imap, mailparser, nodemailer) and setup helper align with an IMAP/SMTP email tool. Minor oddity: package.json author is 'NetEase' while registry owner differs (could be benign).
Instruction Scope
SKILL.md and scripts confine actions to IMAP/SMTP operations and controlled file reads/writes. The setup helper will create a .env and run live IMAP/SMTP tests (including sending a test email to the user's address) — this is expected but notable runtime behavior.
Install Mechanism
No remote downloads or extract-from-URL operations. This is an instruction-plus-local-scripts skill; dependencies are standard npm packages declared in package.json (user must run npm install). No unusual install host or shorteners detected.
Credentials
Declared required env vars (IMAP_HOST/USER/PASS, SMTP_HOST/USER/PASS) match the purpose. However the runtime code requires ALLOWED_READ_DIRS and ALLOWED_WRITE_DIRS (used to gate file reads/writes) and will throw errors or disable functionality if those are missing; these ALLOWED_* variables are not listed in the skill's declared requires.env metadata—this mismatch can cause surprises. The skill also requests full SMTP/IMAP credentials (expected), and the setup script writes them to .env.
Persistence & Privilege
Skill is not force-included (always:false) and does not try to modify other skills or system-wide configs. setup.sh creates/locks a local .env and will run network tests (including sending a test email) — expected for setup but worth noting.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install welderjustin-imap-smtp-email - After installation, invoke the skill by name or use
/welderjustin-imap-smtp-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.11
Version 0.0.11 of welderjustin-imap-smtp-email
- No file changes detected in this version.
- No updates or changes to documentation or functionality.
v0.0.10
- Improved and expanded SKILL.md documentation, covering both IMAP (email receiving) and SMTP (email sending) capabilities.
- Included detailed configuration instructions for supported email providers, usage examples, command-line options, and common troubleshooting tips.
- Clarified requirements for special providers like Gmail and 163.com, including app passwords and authorization codes.
- Added sections for security and dependencies, helping users set up and operate the skill more reliably.
Metadata
Frequently Asked Questions
What is IMAP SMTP Email?
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. Wor... It is an AI Agent Skill for Claude Code / OpenClaw, with 430 downloads so far.
How do I install IMAP SMTP Email?
Run "/install welderjustin-imap-smtp-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is IMAP SMTP Email free?
Yes, IMAP SMTP Email is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does IMAP SMTP Email support?
IMAP SMTP Email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created IMAP SMTP Email?
It is built and maintained by welderjustin (@welderjustin); the current version is v0.0.11.
More Skills