imap-smtp-email

Read, send, and organize email messages via IMAP/SMTP.

1|2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/bluegitter/QClaw --skill imap-smtp-email-bluegitter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imap-smtp-email
Source: https://github.com/bluegitter/QClaw/tree/main/resources/openclaw/config/skills/imap-smtp-email
Command: npx skills add https://github.com/bluegitter/QClaw --skill imap-smtp-email-bluegitter

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Users need a simple, local way to interact with their email accounts for reading, searching, downloading attachments, and sending messages without leaving the terminal or configuring complex clients.

Core Features & Use Cases

  • Check inbox: List new or unread emails with optional limits and time filters.
  • Fetch & download: Retrieve full email content, save attachments to whitelisted directories, and download specific files.
  • Search: Filter emails by sender, subject, date range, read status, and keywords.
  • Mark read/unread: Update email flags directly from the CLI.
  • Send email: Compose plain‑text or HTML messages, include multiple recipients, CC/BCC, and attach files securely.
  • Test connection: Verify IMAP and SMTP settings with a single command.

Quick Start

Ask the imap-smtp-email skill to check my inbox for unread messages.

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 email with attachments using Node.js and SMTP?

Send email with attachments by utilizing Node.js and the nodemailer library to compose plain-text or HTML messages, include multiple recipients, CC/BCC, and securely attach files via an SMTP server connection.

Can I search and download email attachments from an IMAP server via CLI?

Yes, you can search and download email attachments from an IMAP server via CLI by using imap-simple and mailparser to filter messages by sender, subject, or date, and save files to whitelisted directories.

What do I need to configure to read unread IMAP emails locally?

To read unread IMAP emails locally, you need a .env file configured with your IMAP and SMTP credentials, enabling Node.js libraries like imap and imap-simple to establish secure connections for mailbox operations.

How does managing email flags like mark read work through a terminal client?

Managing email flags like mark read through a terminal client works by sending direct commands via the imap protocol to update read or unread statuses, organizing mailbox state without needing a graphical interface.

What is the best way to test IMAP and SMTP connection settings without a full client?

The best way to test IMAP and SMTP connection settings without a full client is running a single connection verification command, which validates your .env credentials and ensures secure Node.js server communication.