Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

IMAP/SMTP Email Tool · kxiandaoyan | DecimalAI

kxiandaoyan/imap-smtp-email

SkillScore73Maintained

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.

productivityby kxiandaoyan

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Personal Assistant pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/kxiandaoyan-imap-smtp-email/SKILL.md

decimalai skills pull kxiandaoyan-imap-smtp-email --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/kxiandaoyan-imap-smtp-email/SKILL.md https://app.decimal.ai/s/kxiandaoyan-imap-smtp-email/SKILL.md

Raw file: /s/kxiandaoyan-imap-smtp-email/SKILL.md ↗ · machine-readable summary at /s/kxiandaoyan-imap-smtp-email.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

Runs

all versions · 30d

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 8d ago

—+97% tokens0% turns73% of whole cases pass with skill (16/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	357%	0%
case-04	✗→✓	▲ Improved	472%	0%
case-05	✗→✓	▲ Improved	55%	0%
case-08	✗→✓	▲ Improved	72%	0%
case-09	✗→✓	▲ Improved	108%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

kxiandaoyan / memoh-v2

internal/skills/defaults/imap-smtp-email/SKILL.md

View on GitHub ↗

License AGPL-3.0Imported 8/3/2026Version v1Bundled 2 files · scripts

Skill contents

scripts/

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.

Environment Variables

This skill requires the following environment variables to be configured:

IMAP Configuration (Receiving Email)

IMAP_HOST - IMAP server hostname (e.g., imap.gmail.com)
IMAP_PORT - IMAP server port (default: 993)
IMAP_USER - Your email address
IMAP_PASS - Your password or app password
IMAP_TLS - Use TLS/SSL connection (default: true)
IMAP_REJECT_UNAUTHORIZED - Verify SSL certificates (default: true, set to false for self-signed certs)
IMAP_MAILBOX - Default mailbox (default: INBOX)

SMTP Configuration (Sending Email)

SMTP_HOST - SMTP server hostname (e.g., smtp.gmail.com)
SMTP_PORT - SMTP server port (587 for STARTTLS, 465 for SSL)
SMTP_SECURE - Use SSL (true for port 465, false for port 587)
SMTP_USER - Your email address
SMTP_PASS - Your password or app password
SMTP_FROM - Default sender email (optional)
SMTP_REJECT_UNAUTHORIZED - Verify SSL certificates (default: true, set to false for self-signed certs)

Security Notes

Store credentials in .env file (add to .gitignore)
For Gmail: use App Password if 2FA is enabled
For 163.com: use authorization code (授权码), not account password

Prerequisites

Node.js must be installed
Run npm install in the skill directory to install dependencies

Configuration

Create .env in the skill folder or set environment variables:

bash
# 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

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

check

Check for new/unread emails.

bash
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.

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

download

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

bash
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.

bash
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.

bash
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.

bash
node scripts/imap.js list-mailboxes

SMTP Commands (Sending Email)

send

Send email via SMTP.

bash
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:

bash
# 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.

bash
node scripts/smtp.js test

Dependencies

bash
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

Want to see if kxiandaoyan/imap-smtp-email would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/21/2026, 10:30 UTC · 22 cases

Measured on 19 comparable cases — below the 22 needed to publish a lift, so this result is shown here but not on the registry card or leaderboard.

Lift

+59%

73% vs 14%

Agent turns

1.0 vs 1.0

Tokens

+97%

2,888.26 vs 1,469.37

fail → pass · 13pass → pass · 3fail → fail · 6

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-02 Please send an email to 'manager@acme.org' and CC 'supervisor@acme.org'. The subject should be 'Project Status Update' and the message body should say 'All deliverables are on schedule.' Also attach the file './reports/weekly.pdf'.	fail→fail	5,570	6,441	+16%	1	1	0%	959	2,830	+195%	0	0	—
case-01 I need to check my inbox for any unread messages sent by 'billing@vendor.com' over the last 3 days. Can you search my email and display the matching message summaries?	fail→pass	3,902	16,677	+327%	1	1	0%	559	2,557	+357%	0	0	—
case-03 I got an email with message UID 8492. Can you pull down all attached files from that email and save them into the folder './attachments/july'?	fail→fail	9,566	5,691	-41%	1	1	0%	1,863	2,546	+37%	0	0	—
case-04 I want to quickly check if any new emails arrived in my INBOX in the past 2 hours. Please run the email check tool to show them.	fail→pass	2,683	3,908	+46%	1	1	0%	426	2,438	+472%	0	0	—
case-05 I need to view the full content of message UID 4501 from my Archive folder. How do I fetch it via CLI?	fail→pass	9,377	1,981	-79%	1	1	0%	1,635	2,532	+55%	0	0	—
case-06 I have reviewed emails UID 101, 102, and 103 in my INBOX. Please mark all three of them as read at once using the CLI scripts.	fail→fail	29,561	6,435	-78%	1	1	0%	6,158	2,892	-53%	0	0	—
case-07 I accidentally read email UID 999. Please mark it as unread using the command line tool.	fail→fail	8,647	4,361	-50%	1	1	0%	1,462	2,883	+97%	0	0	—
case-08 I need to see all available folders on my email account server. What command lists all mailboxes?	fail→pass	8,551	1,544	-82%	1	1	0%	1,419	2,437	+72%	0	0	—
case-09 Email UID 1234 has multiple attachments, but I only want to download 'invoice.pdf' into the local directory './downloads'. Which command should I run?	fail→pass	6,876	1,731	-75%	1	1	0%	1,198	2,491	+108%	0	0	—
case-10 Find all emails with subject containing 'Q3 Report' received after 2024-01-01 in the 'Finance' folder.	fail→pass	6,905	5,440	-21%	1	1	0%	1,213	2,684	+121%	0	0	—
case-11 I want to send an HTML newsletter stored in 'template.html' to 'subscribers@domain.org' with subject 'Monthly Update'. What is the exact SMTP command?	fail→pass	8,587	2,323	-73%	1	1	0%	1,610	2,619	+63%	0	0	—
case-12 Send a plain text email to 'client@domain.com' with subject 'Meeting Notes', body 'Attached is the summary', and blind copy 'audit@domain.com'.	fail→pass	2,592	5,407	+109%	1	1	0%	349	3,125	+795%	0	0	—
case-13 I just configured my SMTP credentials in .env and want to verify the connection by sending a quick test email to myself. Which CLI command performs this test?	fail→pass	9,461	1,455	-85%	1	1	0%	1,691	2,415	+43%	0	0	—
case-14 I am setting up environment variables for a 163.com email account. I have my account password, but the connection keeps failing authentication. What password credential should be used instead?	pass→pass	8,009	3,390	-58%	1	1	0%	1,481	2,838	+92%	0	0	—
case-15 I am configuring environment variables for an SMTP server on port 465 using SSL. Should SMTP_SECURE be set to true or false?	pass→pass	6,082	1,914	-69%	1	1	0%	1,034	2,540	+146%	0	0	—
case-16 I am configuring environment variables for SMTP on port 587 using STARTTLS. What should SMTP_SECURE be set to?	pass→pass	8,164	1,900	-77%	1	1	0%	1,475	2,533	+72%	0	0	—
case-17 My company's internal IMAP server uses a self-signed SSL certificate. How do I configure environment variables so Node does not reject unauthorized certs?	fail→pass	10,380	2,785	-73%	1	1	0%	1,829	2,736	+50%	0	0	—
case-18 Search for read emails from 'support@vendor.com' received before 2023-12-31 with a limit of 5 results.	fail→pass	7,506	2,692	-64%	1	1	0%	537	2,512	+368%	0	0	—
case-19 Send an email with subject 'Urgent Notice' and body 'Please review immediately' to 'alice@test.com,bob@test.com' and CC 'carol@test.com'.	fail→pass	4,707	1,834	-61%	1	1	0%	715	2,513	+251%	0	0	—
case-20 I want to configure DKIM DNS TXT records for my domain 'example.com' to prevent outgoing emails from being flagged as spam. How do I generate the public and private DKIM keys using this email tool?	fail→pass	11,435	8,318	-27%	1	1	0%	1,994	3,624	+82%	0	0	—
case-21 I am building a raw MIME parser script in Python to parse multipart RFC 822 raw headers directly from a byte stream. Can you write a Python script that parses raw MIME structures?	fail→fail	19,879	12,711	-36%	1	1	0%	3,799	4,699	+24%	0	0	—
case-22 How do I install and configure a local Postfix mail transfer agent (MTA) service on Ubuntu to act as a port 25 relay?	fail→fail	16,272	11,852	-27%	1	1	0%	3,070	4,383	+43%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted, and 19 counted toward the lift figure. The other 3 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +59 percentage points is the difference between those two pass rates over the 19 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 13.6%
Pass rate with the skill: 72.7%
Cases attempted: 22
Cases counted toward lift: 19
Cases that regressed: 0
Skill version measured: v1
Run completed: 8/21/2026, 10:30 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Prompt

I need to check my inbox for any unread messages sent by 'billing@vendor.com' over the last 3 days. Can you search my email and display the matching message summaries?

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run73

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+98% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 8 days ago

Other measured skills in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

kxiandaoyan/imap-smtp-email

SkillSafety

Source

IMAP/SMTP Email Tool

Environment Variables

IMAP Configuration (Receiving Email)

SMTP Configuration (Sending Email)

Security Notes

Prerequisites

Configuration

Common Email Servers

IMAP Commands (Receiving Email)

check

fetch

download

search

mark-read / mark-unread

list-mailboxes

SMTP Commands (Sending Email)

send

test

Dependencies

Security Notes

Troubleshooting

How this skill was measured

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Related skills