imap-smtp-email

Read, search, and send email via IMAP/SMTP from a CLI tool.

1|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/polaris-dxz/xclaw --skill imap-smtp-email-polaris-dxz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imap-smtp-email
Source: https://github.com/polaris-dxz/xclaw/tree/main/apps/desktop/openclaw-runtime/config/skills/imap-smtp-email
Command: npx skills add https://github.com/polaris-dxz/xclaw --skill imap-smtp-email-polaris-dxz

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Reads and sends email via IMAP/SMTP from a single tool, reducing manual switching between apps and servers.

Core Features & Use Cases

  • Read new and unread messages across IMAP servers
  • Fetch full content and attachments
  • Search mailboxes with filters (from, subject, date)
  • Mark messages as read/unread
  • Send emails with attachments via SMTP
  • Works with Gmail, Outlook, 163/126/188 and other servers

Quick Start

Configure .env with your IMAP/SMTP credentials and run node scripts/imap.js check to verify connectivity.

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 reading and sending emails via IMAP and SMTP using Node.js?

You can automate email management via IMAP and SMTP using a Node.js CLI tool to read, search, and send emails. It consolidates server interactions into a single interface, reducing manual switching between different email applications and servers.

How do I send emails with file attachments from the command line?

You can send emails with file attachments from the command line using the Skill's SMTP send command. The CLI leverages the nodemailer dependency to handle outgoing messages and supports attaching files directly through command line execution.

Can I search and fetch specific emails from Gmail or Outlook using a CLI?

Yes, you can fetch and search emails from major providers like Gmail and Outlook using the CLI's search command. The tool applies filters such as sender, subject, and date to query mailboxes and retrieve matching message content via IMAP.

What environment variables do I need to configure for IMAP and SMTP access?

You need to configure environment variables for your IMAP and SMTP credentials and TLS settings in a .env file. These variables provide the necessary authentication details required to establish secure connections with your email server.

Does this email automation tool support marking messages as read or unread?

Yes, the email automation tool supports marking messages as read or unread. Alongside reading and fetching content, the CLI exposes commands to update the read status of your emails directly on the IMAP server.

What are the limitations of using Node.js for IMAP email automation?

IMAP email automation via Node.js requires proper TLS configuration and accurate environment variables for connectivity. Users must ensure their email provider permits external IMAP/SMTP access, as incorrect credentials or blocked ports will prevent the CLI from connecting.