Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
boomsystel-code avatar

Imap Smtp Email

  • 1.8k installs
  • Updated February 8, 2026
  • boomsystel-code/openclaw-workspace

imap-smtp-email is an agent skill for reading and sending email via IMAP and SMTP CLI scripts across major providers.

About

The imap-smtp-email skill provides IMAP and SMTP email automation via Node.js CLI scripts for reading, searching, marking, and sending mail. Configuration uses .env with IMAP_HOST, SMTP_HOST, TLS settings, and credentials for Gmail, Outlook, 163.com, 126.com, QQ Mail, and other standard servers. IMAP commands include check, fetch, download attachments, search with unseen and date filters, mark-read, and list-mailboxes. SMTP commands cover send with HTML, attachments, CC and BCC, plus connection test. Security notes require app passwords for Gmail, authorization codes for 163.com, and .env in gitignore. Use when agents need programmatic inbox checks, email search, or outbound SMTP sending.

  • IMAP check, fetch, search, mark-read, and attachment download commands.
  • SMTP send with HTML, attachments, CC, BCC, and connection test.
  • Provider table for Gmail, Outlook, 163, 126, QQ, and yeah.net.
  • Env-based config: IMAP_HOST, SMTP_PORT, TLS, and credential vars.
  • 163.com requires authorization code; Gmail needs app password with 2FA.

Imap Smtp Email by the numbers

  • 1,846 all-time installs (skills.sh)
  • +4 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #262 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

imap-smtp-email capabilities & compatibility

Capabilities
imap inbox check and search · attachment download · smtp send with html and attachments · multi provider configuration
Pricing
Bring your own API key
From the docs

What imap-smtp-email says it does

Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes
SKILL.md
For 163.com: use authorization code (授权码), not account password
SKILL.md
npx skills add https://github.com/boomsystel-code/openclaw-workspace --skill imap-smtp-email

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1.8k
Last updatedFebruary 8, 2026
Repositoryboomsystel-code/openclaw-workspace

How do I check inbox, search mail, or send email with attachments via IMAP and SMTP?

Read, search, send, and manage email via IMAP and SMTP CLI scripts for Gmail, Outlook, and 163 providers.

Who is it for?

Developers automating email read, search, mark-read, and send workflows for Gmail, Outlook, or 163.

Skip if: Skip for OAuth-only email APIs or marketing campaign platforms without IMAP SMTP access.

When should I use this skill?

User mentions IMAP SMTP email, check unread mail, send email attachment, or mailbox search.

What you get

Working IMAP inbox checks, filtered searches, and SMTP sends using configured provider credentials.

  • Inbox fetch output
  • Mailbox search results
  • Sent SMTP replies

By the numbers

  • 8+ named mailbox providers including Gmail and Outlook
  • 3 IMAP npm scripts: check, fetch, search

Files

SKILL.mdMarkdownGitHub ↗

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
IMAP_USER=your@email.com
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)
SMTP_USER=your@gmail.com          # Your email address
SMTP_PASS=your_password           # Your password or app password
SMTP_FROM=your@gmail.com          # Default sender email (optional)
SMTP_REJECT_UNAUTHORIZED=true     # Set to false for self-signed certs

Common Email Servers

ProviderIMAP HostIMAP PortSMTP HostSMTP Port
163.comimap.163.com993smtp.163.com465
vip.163.comimap.vip.163.com993smtp.vip.163.com465
126.comimap.126.com993smtp.126.com465
vip.126.comimap.vip.126.com993smtp.vip.126.com465
188.comimap.188.com993smtp.188.com465
vip.188.comimap.vip.188.com993smtp.vip.188.com465
yeah.netimap.yeah.net993smtp.yeah.net465
Gmailimap.gmail.com993smtp.gmail.com587
Outlookoutlook.office365.com993smtp.office365.com587
QQ Mailimap.qq.com993smtp.qq.com587

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 <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)

fetch

Fetch full email content by UID.

node scripts/imap.js fetch <uid> [--mailbox INBOX]

download

Download all attachments from an email, or a specific attachment.

node 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)

search

Search emails with filters.

node 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-unread

Mark message(s) as read or unread.

node scripts/imap.js mark-read <uid> [uid2 uid3...]
node scripts/imap.js mark-unread <uid> [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 <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:

# Simple text email
node scripts/smtp.js send --to recipient@example.com --subject "Hello" --body "World"

# HTML email
node scripts/smtp.js send --to recipient@example.com --subject "Newsletter" --html --body "<h1>Welcome</h1>"

# Email with attachment
node scripts/smtp.js send --to recipient@example.com --subject "Report" --body "Please find attached" --attach report.pdf

# Multiple recipients
node scripts/smtp.js send --to "a@example.com,b@example.com" --cc "c@example.com" --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)
  • 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

How it compares

Use this for agent mailbox read and reply; use a transactional email API skill for outbound product email at scale.

FAQ

Which providers are supported?

Any standard IMAP SMTP server including Gmail, Outlook, 163.com, 126.com, QQ Mail, and yeah.net.

How is email configured?

Set IMAP and SMTP host, port, user, password, and TLS flags in a .env file in the skill folder.

Is imap-smtp-email safe to install?

Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.