An n8n community node for integrating Apple iCloud into your workflows — Mail, Calendar, and Contacts, with full AI Agent tool support.

• usableAsTool: true — Works as an AI Agent tool in n8n
• iCloud Trigger — polls your IMAP mailbox for new emails (configurable interval)
• Supports filtering emails by sender, subject, read status, date
• Email attachments — attach binary files from upstream nodes (e.g. Read File, Download)
• CalDAV auto-discovery (handles p01-caldav.icloud.com, p02-..., etc.)
• Full-day event support
• vCard 3.0 contact management

1. Two-Factor Authentication must be enabled on your Apple ID
2. App-Specific Password required — your regular Apple ID password will not work

1. Sign in at appleid.apple.com
2. Go to Sign-In and Security → App-Specific Passwords
3. Click Generate an app-specific password
4. Enter a label (e.g., "n8n iCloud Integration")
5. Copy the generated password (format: xxxx-xxxx-xxxx-xxxx)

1. Open your n8n instance → Settings → Community Nodes
2. Click Install
3. Enter: n8n-nodes-icloud
4. Click Install

npm install n8n-nodes-icloud

Or via Docker:

docker exec <container> npm install --prefix /home/node/.n8n/nodes n8n-nodes-icloud
docker restart <container>

Set this environment variable on your n8n instance:

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

In n8n, add new credentials of type "Apple iCloud Credentials":

Why is the Mail Address field needed? iCloud's IMAP and SMTP servers (imap.mail.me.com, smtp.mail.me.com) only accept @icloud.com, @me.com, or @mac.com as the username. If your Apple ID is a Gmail or custom domain address, IMAP/SMTP authentication will fail with "Command failed" — even though Calendar and Contacts work fine (they use any Apple ID via CalDAV/CardDAV). Solution: Enter your iCloud mail address in the optional field. Calendar and Contacts are unaffected.

Sends an email via iCloud Mail SMTP (smtp.mail.me.com:587, STARTTLS).

Attaching files: Connect an upstream node that outputs binary data (e.g. Read/Write Files from Disk, HTTP Request, Google Drive). In the Attachments section, set Binary Property to the name of the binary field (default: data). Multiple attachments are supported.

[Read File] ──→ [iCloud: Send Email]
                  Attachments:
                    Binary Property: data      ← matches output of Read File node
                    File Name:       (optional override)

Retrieves emails from an IMAP mailbox (imap.mail.me.com:993, SSL).

Retrieves a single email by its IMAP UID (includes full body).

Moves an email from one mailbox to another.

Permanently deletes an email by UID.

Returns all calendars with their URLs, display names, and colors.

Retrieves events from one or all calendars, optionally filtered by date range.

Returns: { success, uid, url, etag, summary, start, end }

Updates fields on an existing event. Requires Calendar (dropdown) + Event UID (returned as uid by Get Events or Create Event).

Deletes an event. Requires Calendar (dropdown) + Event UID.

Returns all contacts, with optional search filtering by name or email.

Updates fields on an existing contact. Requires Contact UID (returned as uid by Get Contacts or Create Contact).

Deletes a contact. Requires Contact UID.

The iCloud Trigger node polls your IMAP mailbox at a configurable interval and fires whenever new emails arrive.

How it works:

• On first activation, the current highest IMAP UID is recorded — no flood of old emails (unless Initial Lookback > 0)
• On each poll, only emails with a UID higher than the last seen are returned
• On manual test run, the most recent email is returned so you can see the data shape
• All filters are AND-combined (every active filter must match)

Output fields: uid, messageId, from, to, cc, subject, date, flags, size

Tip: Use Get Email by ID after the trigger to fetch the full email body (the trigger returns envelope data only for efficiency).

This node has usableAsTool: true, so it works directly as a tool in n8n AI Agent workflows.

Example prompts:

• "Check my iCloud inbox and summarize unread emails from the last 24 hours"
• "Create a calendar event 'Team Meeting' tomorrow at 2pm to 3pm"
• "Find the contact John Doe and return his phone number"
• "Move all emails from newsletter@example.com to the Archive folder"

Setup:

1. Add an AI Agent node to your workflow
2. Connect a language model (e.g., Claude, GPT-4)
3. In the Tools section, add the iCloud node
4. Configure credentials — the agent uses them for all tool calls

If you were using the old n8n-nodes-apple-icloud package (Calendar-only):

1. Uninstall the old package via n8n Community Nodes UI or manually
2. Install n8n-nodes-icloud (this package)
3. Re-create your iCloud credentials (same fields — Apple ID + App-Specific Password)
4. Calendar workflows remain compatible; Mail and Contacts are new additions

Note: CalDAV and CardDAV use account-specific server endpoints (p01-caldav.icloud.com, p02-...). The tsdav library handles server discovery automatically via PROPFIND.

• No OAuth2 — Apple does not offer OAuth2 for third-party IMAP/SMTP/DAV access. App-Specific Passwords are the only supported method.
• Trigger is poll-based — The iCloud Trigger polls IMAP at the n8n-configured interval (minimum ~1 minute). IMAP IDLE (true server push) exists as an RFC standard but is architecturally incompatible with n8n's trigger model, which only supports short-lived poll callbacks or incoming webhooks — not persistent TCP connections. For near-real-time delivery, an external IMAP IDLE daemon that calls an n8n Webhook node is the recommended workaround.
• Calendar/Contacts trigger — Not yet implemented. Only new-email triggering is supported.
• iCloud+ / Hide My Email — Alias addresses work normally as long as they are active in your Apple ID settings.
• Shared calendars — Read access to shared calendars should work; write access depends on the sharing permissions set by the calendar owner.

Authentication errors (Invalid credentials / 535):

• Ensure Two-Factor Authentication is active on your Apple ID
• Use an App-Specific Password, not your regular Apple ID password
• Verify the password has not been revoked at appleid.apple.com

IMAP connection errors:

• Verify iCloud Mail is enabled under iCloud settings
• Check that IMAP access is enabled in iCloud Mail settings

CalDAV/CardDAV errors (403 Forbidden):

• Ensure iCloud Calendar / Contacts sync is enabled in your Apple ID settings
• Auto-discovery requires a valid Apple ID with active iCloud services

Node not appearing in n8n:

• Restart n8n after installation
• Confirm N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true is set if using as AI tool
• Check n8n logs for loading errors

MIT — see LICENSE

OzDreamWalk — ozdreamwalk.com

• npm Package
• GitHub Repository
• n8n Community Nodes Documentation
• Apple App-Specific Passwords
• iCloud Mail SMTP/IMAP Settings
• Apple CalDAV Setup Guide