n8n-nodes-icloud-calendar

This is an n8n community node that lets you interact with iCloud Calendar using the CalDAV protocol.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Install via n8n UI

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-icloud-calendar in the Enter npm package name field
4. Agree to the risks and select Install

Install Manually

To get started locally, install the dependencies in both the root directory and in the n8n directory:

npm install

Credentials

To use this node, you need to create an app-specific password for your Apple ID:

1. Go to appleid.apple.com
2. Sign in with your Apple ID
3. Navigate to Security > App-Specific Passwords
4. Generate a new password
5. Use this password along with your Apple ID email in the n8n credentials

Operations

Get Calendars

Retrieve a list of all available calendars from your iCloud account.

Get Events

Fetch events from a specific calendar with optional date range filtering.

Parameters:

• Calendar Name or ID (required)
• Start Date (optional, defaults to today)
• End Date (optional, defaults to 1 month from start)
• Limit (optional, defaults to 50)

Get Single Event

Retrieve details of a specific event by its ID.

Parameters:

• Calendar Name or ID (required)
• Event ID (required)

Create Event

Create a new calendar event.

Parameters:

• Calendar Name or ID (required)
• Event Title (required)
• Start Date (required)
• End Date (required)
• Timezone (optional)

Additional Fields:

• Description
• Location
• All Day (boolean)
• Show As (Busy/Free)
• URL
• Status (Confirmed/Tentative/Cancelled)
• Attendees (email, name, role)
• Attachments (URL, filename, MIME type)
• Recurrence (frequency, interval, end condition, weekdays, month day)

Delete Event

Delete an event from a calendar.

Parameters:

• Calendar Name or ID (required)
• Event ID (required)

Free/Busy Query

Check availability for a specific calendar during a time range.

Parameters:

• Calendar Name or ID (required)
• Start Date (required)
• End Date (required)

Recurrence

The node supports recurring events with the following options:

• Frequency: Daily, Weekly, Monthly, Yearly
• Interval: How often the event repeats (e.g., every 2 weeks)
• End Condition:
  • Never (infinite recurrence)
  • After N Occurrences (specify count)
  • On Specific Date (specify until date)
• By Week Day: For weekly recurrence, select specific days
• By Month Day: For monthly recurrence, specify day of month

Compatibility

• Minimum n8n version: 0.200.0
• Tested with n8n version: 1.0.0+

Resources

• n8n community nodes documentation
• iCloud CalDAV documentation

License

MIT