> ⚠️ Security Notice / Fork Disclaimer
>
> This IMAP node is a modified fork of
> .
>
> Unlike the original node, this fork allows you to pass email address and password as plain-text fields (variables) inside the workflow, e.g. from an n8n Data Table.
> This makes it possible to support multiple user accounts dynamically without creating a separate n8n credential and node per user – the data table acts as a single point of truth.
>
> Important: This introduces additional security risks, because credentials are handled in clear text at workflow level.
> This fork is intended only for self-hosted, private setups where this trade-off is understood and accepted.
> Do not use it in untrusted, shared, or externally managed environments.

n8n-nodes-imap

This is an n8n community node that adds support for IMAP email servers.

- Installation
- Operations
- Credentials
- Troubleshooting & Debug
- Version history
- For Developers: Contributing Guide | Developer Quick Start

Installation

Follow the installation guide in the n8n community nodes documentation.

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

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

NPMJS: n8n-nodes-imap

Operations

- Mailbox
- Get list of mailboxes (including status information like number of messages)
- 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
- Download attachments from an email
- Permanently delete an email from a mailbox
- Move an email to another mailbox
- Copy an email into another mailbox
- Set/remove flags on an email ("seen", "answered", "flagged", "deleted", "draft")
- Create email draft in a mailbox
- Use n8n-nodes-eml node to create complex emails. It supports attachments and other features.

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.

Troubleshooting & Debug

If you encounter issues with the IMAP node, you can enable debug mode to get detailed logs and diagnostic information:

$3

Set the following environment variable before starting n8n:

``bash
N8N_NODES_DEBUG_ENABLED=true
`

When debug mode is enabled:

- The IMAP node will create an additional "debug" output containing detailed logs
- Enhanced error messages and diagnostic information will be available
- Connection and operation details will be logged for troubleshooting

$3

1. Set environment variables:

`bash
N8N_LOG_LEVEL=debug
N8N_NODES_DEBUG_ENABLED=true
``

2. Restart your n8n instance

3. Execute your workflow - the IMAP node will now provide debug output

4. Check the debug output - connect the debug output to a Set node or similar to view the diagnostic information

$3

When reporting bugs or issues:

- Always enable debug mode first
- Include the debug output in your issue report
- Remove any sensitive information (passwords, email addresses, etc.) from logs
- Use our issue templates for structured bug reports