skills.rest
234194027-cpu
234194027-cpuCOMMUNITY
Explore all skills by this author →
GitHub

imap-smtp-email

Send SMTP emails and retrieve IMAP mailbox messages with attachments.

Updated May 4, 2026
Search Tags:#authentication#email#smtp#attachments#imap#inbox search#personal mailbox
One-click install
npx skills add https://github.com/234194027-cpu/xianclaw --skill imap-smtp-email-234194027-cpu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imap-smtp-email
Source: https://github.com/234194027-cpu/xianclaw/tree/main/resources/openclaw/config/skills/imap-smtp-email
Command: npx skills add https://github.com/234194027-cpu/xianclaw --skill imap-smtp-email-234194027-cpu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dotenv, imap, imap-simple, mailparser, nodemailer, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

It solves the problem of managing personal email workflows—sending, receiving, searching, and downloading attachments—without manually operating multiple command-line tools or managing provider-specific setups.

Core Features & Use Cases

  • Full personal email gateway (IMAP + SMTP): Send emails to any recipient with To/CC/BCC, plain text or HTML, and attachments.
  • Mailbox reading & retrieval: Search inboxes using criteria (recent time window, subject/from, unread/seen), fetch message details by UID, and list folders/mailboxes.
  • Attachment download with safety guardrails: Download attachments by UID into a user-approved directory whitelist and restrict file write access.

Quick Start

Use the skill by asking to send an email: send a message from your bound personal account to [email protected] with subject "Hello" and body "World".

Frequently Asked Questions about imap-smtp-email

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send emails with attachments using SMTP and IMAP from a personal mailbox?▼

To send emails with attachments, this Skill routes SMTP requests to send rich HTML messages with CC and BCC support from your bound personal mailbox, handling file transmission automatically.

How does IMAP inbox search work for filtering unread messages by subject or sender?▼

IMAP inbox search works by applying filtering criteria like recent time windows, unread status, or matching subject and sender addresses to retrieve specific messages from your connected personal mailbox folders.

Can I download email attachments safely to a specific directory using IMAP?▼

Yes, you can download email attachments safely using a strict file-access whitelist that restricts write operations to user-approved directories, preventing unauthorized file system access during IMAP message retrieval.

What environment configuration do I need to connect nodemailer and imap-simple?▼

You need environment-driven provider configuration and credential token bootstrapping setup via dotenv to connect nodemailer and imap-simple, enabling Node-based execution for your personal email account operations.

What is the best way to fetch an email message by UID in a personal mailbox?▼

The best way to fetch an email message by UID is through the IMAP retrieval mechanism, which locates the exact message in your inbox and extracts its full details, including body content and attachment metadata.

Related Skills

Explore More Content & Communication Skills→
KrishavRajSinghKrishavRajSingh

email

Send and receive emails via IMAP/SMTP using curl.

Community
Intermediate
CastrozanCastrozan
3

pdf

Read PDF content, fill forms, and extract text, tables, and metadata.

Community
Basic
kortix-aikortix-ai
6

email

Send and receive emails via IMAP and SMTP using curl commands.

Official
Intermediate
ma08ma08
28

gws-gmail

Automate Gmail mailbox operations for sending, reading, and organizing messages.

Community
Intermediate