n8n-nodes-imap-enhanced

This is an enhanced n8n community node that adds support for IMAP email servers with advanced features including custom labels, limit parameters, and professional HTML to Markdown conversion.

• Installation
• Operations
• Credentials
• Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Use n8n-nodes-imap-enhanced in N8N settings to install the stable version.

To install beta version, use n8n-nodes-imap-enhanced@beta.

NPMJS: n8n-nodes-imap-enhanced

Operations

• Mailbox
  • Get list of mailboxes (including status information like number of messages) with limit parameter
  • Get status of a mailbox (number of messages, etc.)
  • Create a mailbox
  • Rename a mailbox
  • Delete a mailbox (disabled due to danger of accidental data loss and no apparent use case)
• Email
  • Get list of emails in a mailbox with limit parameter and three content formats (text, markdown, html)
  • Download attachments from an email
  • Move an email to another mailbox
  • Copy an email into another mailbox
  • Set/remove flags on an email ("seen", "answered", "flagged", "deleted", "draft") with custom labels support
  • Manage custom labels (add, remove, set custom labels/keywords)
  • Create email draft in a mailbox
    • Use n8n-nodes-eml node to create complex emails. It supports attachments and other features.

New Features

Professional Content Processing

• Three Content Formats: Returns text, markdown, and html fields for email body content
• Professional Markdown: Uses node-html-markdown library for accurate HTML to Markdown conversion
• Clean Text: Converts HTML to readable plain text with proper formatting
• Standard Fields: Always includes flags/labels and structured envelope data

Custom Labels Support

• Search by Custom Labels: Search emails using custom labels/keywords
• Label Management: Add, remove, or set custom labels on emails
• Flexible Format: Support for labelName:labelValue format (e.g., "Priority:High")

Limit Parameters

• Email List Limit: Control maximum number of emails returned
• Mailbox List Limit: Control maximum number of mailboxes returned
• Performance Optimization: Prevents excessive data fetching

Output Structure

{
  "seq": 415,
  "uid": 18718,
  "mailboxPath": "INBOX",
  "envelope": {
    "subject": "Email Subject",
    "from": [{"name": "Sender", "address": "sender@example.com"}],
    "to": [{"name": "Recipient", "address": "recipient@example.com"}],
    "date": "2025-01-XX",
    "messageId": "<message-id>"
  },
  "labels": ["\\Seen"],
  "size": 12345,
  "text": "Plain text content",
  "markdown": "# Header\n\n**Bold** text",
  "html": "<p>HTML content</p>"
}

Credentials

Currently, this node supports only basic authentication (username and password).
OAuth2 authentication is not supported yet.

NOTE: You can reuse core N8N IMAP Trigger node credentials for this node.