skills.rest
xintuchain
xintuchainCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

imap-smtp-email

Manage email reading and sending via IMAP and SMTP across multiple accounts.

Updated Aug 27, 2026
Search Tags:#automation#email#smtp#attachments#multi-account#imap#mailbox
One-click install
npx skills add https://github.com/xintuchain/tongtong --skill imap-smtp-email-xintuchain
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imap-smtp-email
Source: https://github.com/xintuchain/tongtong/tree/main/skills/imap-smtp-email
Command: npx skills add https://github.com/xintuchain/tongtong --skill imap-smtp-email-xintuchain

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill removes the friction of interacting with multiple email accounts and servers by providing a unified CLI to read, search, download attachments, and send messages using standard IMAP and SMTP protocols.

Core Features & Use Cases

  • Multi-account support: Configure multiple accounts in a single .env and select accounts by name to check, fetch, search, or send mail.
  • Receive and inspect mail: Check for new/unread messages, fetch full message content by UID, search mailboxes with filters, and list mailboxes.
  • Attachment management & safety: Download attachments to whitelisted directories only, with filename sanitization and explicit read/write ACLs.
  • Send mail via SMTP: Send plain or HTML emails with attachments, test SMTP connectivity, and support provider-specific guidance (Gmail app passwords, 163.com authorization codes).
  • Use Case: Automate inbox monitoring for a support inbox, fetch message bodies and attachments for triage, and reply or forward reports through SMTP.

Quick Start

Run the setup script to configure an account, then use the CLI to check unread messages or send an email using the configured account.

Frequently Asked Questions about imap-smtp-email

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

FAQPage Schema
How do I automate checking unread IMAP messages across multiple email accounts?▼

You can automate checking unread IMAP messages across multiple email accounts by configuring credentials in a local .env file and running CLI commands to select accounts and fetch unread mail. The Skill supports Gmail, Outlook, and 163.com servers using the imap and mailparser libraries.

Can I download email attachments via IMAP to a specific local directory?▼

Yes, you can download email attachments via IMAP to a specific local directory. The Skill enforces safety by only allowing downloads to explicitly whitelisted directories, sanitizing filenames, and applying strict read/write ACLs during the attachment management process.

How does sending email with attachments via SMTP work with provider-specific authentication?▼

Sending email with attachments via SMTP works by using the nodemailer library to transmit plain or HTML messages. The Skill provides provider-specific guidance for SMTP authentication, including Gmail app passwords and 163.com authorization codes.

Do I need a .env file to manage multiple IMAP and SMTP mailboxes?▼

Yes, you need a .env file to manage multiple IMAP and SMTP mailboxes. Local configuration via a .env file or a config directory is required to store credentials, define multiple accounts, and whitelist file read/write directories before executing CLI commands.

What is the best way to search and fetch full message content by UID using IMAP?▼

The best way to search and fetch full message content by UID using IMAP is through CLI commands backed by the imap and mailparser libraries. You can search mailboxes with filters, fetch complete message bodies by UID, and list available mailboxes.

Related Skills

Explore More Software Engineering Skills→
SriRamkunamsettySriRamkunamsetty

himalaya

Configure Himalaya for terminal email management via IMAP/SMTP backends.

Community
Intermediate
Sim-hub22Sim-hub22

resend-inbound

Verify Resend webhook signatures and retrieve email content and attachments.

Community
Intermediate
yjwongyjwong
53

email

Read and search Lark Mail emails via IMAP with a local cache.

Community
Intermediate
ZJU-REALZJU-REAL
195

email

Manage email messages and attachments via a preconfigured himalaya CLI account.

Official
Advanced