imap-email

N8N custom node for IMAP email retrieval and filtering

Package Information

Released: 8/2/2025
Downloads: 14 weekly / 62 monthly
Latest Version: 0.1.0
Author: SamoM225

Documentation

n8n-nodes-imap-email

This is an n8n community node for retrieving and filtering emails from any IMAP-compatible email server.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This node supports the following operation:

  • Get Emails: Retrieve emails from a specified mailbox (e.g., INBOX) with advanced filtering options.

Credentials

You need to provide IMAP server credentials:

  • Host: IMAP server address (e.g., imap.gmail.com)
  • Port: IMAP port (usually 993 for SSL/TLS)
  • Email: Your email address
  • Password: Your email password or app-specific password
  • TLS: Whether to use TLS/SSL (recommended: true)

Parameters

  • Mailbox: The mailbox to search in (e.g., INBOX, Sent)
  • Limit: Max number of results to return (default: 50)
  • Read Status: Filter by all, unread, or read emails
  • Additional Options:
    • Date From / Date To: Filter by date range
    • From Filter: Filter by sender
    • To Filter: Filter by recipient
    • Subject Filter: Filter by subject text
    • Has Attachments: Only emails with attachments
    • Include Body: Whether to include email body content
    • Include Attachments: Whether to include attachment data

Compatibility

  • Requires n8n v1.0.0 or higher
  • Tested with Node.js 20+

Usage

  1. Install this node as a community package in your n8n instance.
  2. Add the IMAP Email node to your workflow.
  3. Configure your IMAP credentials and desired filters.
  4. Run the workflow to retrieve and process emails.

Resources

Version history

  • 0.1.0: Initial release

License

MIT

Discussion