imap-smtp-email

Name: imap-smtp-email
Availability: InStock
Author: 234194027-cpu

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

Ready to run

npx skills add https://github.com/234194027-cpu/xianclaw --skill imap-smtp-email-234194027-cpu

💬 Prompt for ChatGPT / Claude Chat▼

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.