imap-smtp-email

Reads and sends emails via IMAP and SMTP with attachments and HTML/text support.

1|Updated May 13, 2026
One-click install
npx skills add https://github.com/wtgoku-create/PopiStudio --skill imap-smtp-email-wtgoku-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imap-smtp-email
Source: https://github.com/wtgoku-create/PopiStudio/tree/main/SKILLs/imap-smtp-email
Command: npx skills add https://github.com/wtgoku-create/PopiStudio --skill imap-smtp-email-wtgoku-create

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you programmatically check, read, search, and manage email in a local, supervised workflow, and send new emails reliably through standard mail servers.

Core Features & Use Cases

  • IMAP inbox operations: Check for new/unread messages, fetch full email content by UID, search using common filters, and mark messages as read/unread.
  • Attachment handling: Download attachments from a specified email UID to a chosen directory.
  • SMTP sending: Send plain text or HTML emails to one or more recipients, including CC/BCC and file attachments.
  • Use case: You want to automatically locate the latest unread invoice emails from your mailbox, download the attached PDFs, and then email a summary report to a team member.

Quick Start

Ask Popiai to use the imap-smtp-email skill to check your INBOX for the 10 most recent unread emails and return their senders, subjects, dates, and UIDs.

Frequently Asked Questions about imap-smtp-email

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

FAQPage Schema
How do I read and search emails using IMAP?

To read and search emails using IMAP, you connect to standard mail servers and apply criteria like UID or unread status to retrieve message content. This allows you to monitor an inbox and fetch full emails programmatically.

Can I send HTML emails with attachments via SMTP?

Yes, you can send HTML emails with attachments via SMTP by authenticating to your mail server and composing outbound messages. This supports sending plain text or HTML content to recipients, including CC and BCC.

Does this IMAP and SMTP workflow work with Gmail and Outlook?

Yes, this IMAP and SMTP workflow works with Gmail and Outlook. It loads server settings from environment variables and authenticates to standard servers, including Gmail, Outlook, and 163-family providers, for real-world business communication.

What is the best way to automatically download email attachments from unread messages?

The best way to download email attachments is to search for unread messages by criteria, identify the target email UID, and download attached files to a chosen local directory, facilitating automated inbox workflows like retrieving PDF invoices.

Do I need environment variables to authenticate with standard mail servers?

Yes, you need environment variables to authenticate with standard mail servers. The workflow requires loading IMAP and SMTP settings from the skill directory environment variables to securely connect and manage mailbox operations.

How do I mark retrieved messages as read or unread after fetching them?

You mark retrieved messages as read or unread after fetching them by applying mailbox operations to the specific message UID. This maintains accurate inbox status during automated inbox monitoring and message retrieval workflows.