n8n-nodes-tscaldav

N8N community node for CalDAV calendar integration using ts-caldav.

This node allows you to interact with CalDAV calendar servers directly from your n8n workflows. It supports popular providers like Google Calendar, iCloud, Fastmail, Yahoo, GMX, Nextcloud, and any custom CalDAV server.

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-tscaldav and confirm

Then restart n8n if needed.

Features

Resources

• Calendar: List all calendars from the server
• Event: Full CRUD operations for calendar events

Operations

| Resource | Operation | Description | |----------|-----------|-------------| | Calendar | Get Many | List all calendars | | Event | Get Many | Fetch events (with optional date filtering) | | Event | Get | Fetch a specific event by UID | | Event | Create | Create a new event | | Event | Update | Update an existing event | | Event | Delete | Delete an event |

Event Features

• Basic fields: Summary, start/end times, description, location
• Status: Tentative, Confirmed, or Cancelled
• All-day events: Mark events as whole-day
• Timezones: Specify start and end timezones
• Recurrence: Daily, weekly, monthly, yearly with advanced options
• Alarms: Display popups, audio alerts, or email reminders

Supported Providers

The node includes pre-configured server URLs for:

| Provider | Status | Notes | |----------|--------|-------| | Google Calendar | Supported | Requires app-specific password | | iCloud | Supported | Requires app-specific password | | Fastmail | Supported | Works with account password | | Yahoo Calendar | Supported | May require app-specific password | | GMX | Supported | Works with account password | | Nextcloud | Supported | Provide your server URL | | Custom | Supported | Any CalDAV-compliant server |

Credentials

⚠️ PLEASE NOTE
When setting up the N8N credential, you might get an error about connection failure. You can ignore this alert and save successfully. If everything is set up correctly, you'll be able to see you calendars from list component.

1. Create new credentials of type CalDAV API
2. Select your server preset (or Custom)
3. Enter your username and password
4. For iCloud/Google: Generate an app-specific password

Getting App-Specific Passwords

iCloud:

1. Go to appleid.apple.com
2. Sign in > Security > App-Specific Passwords
3. Generate a password for n8n

Google:

1. Enable 2FA on your Google account
2. Go to myaccount.google.com/apppasswords
3. Generate a password for n8n

Usage Examples

List All Calendars

1. Add a CalDAV node
2. Select Calendar resource
3. Select Get Many operation
4. Execute

Get Events from a Calendar

1. Add a CalDAV node
2. Select Event resource
3. Select Get Many operation
4. Choose a calendar from the dropdown
5. Optionally set date range filters
6. Execute

Create a Recurring Event

1. Add a CalDAV node
2. Select Event resource, Create operation
3. Set Summary, Start, End times
4. Under Recurrence, add a rule:
   • Frequency: Weekly
   • Interval: 1
   • By Day: Monday, Wednesday, Friday
5. Execute

Update an Event

1. First, use Get or Get Many to retrieve the event
2. Note the uid, href, and etag from the response
3. Add another CalDAV node with Update operation
4. Fill in the UID, Href, and ETag fields
5. Set the new values for Summary, Start, End, etc.
6. Execute

Development

# Clone the repository
git clone https://github.com/ivorocha/n8n-nodes-tscaldav.git
cd n8n-nodes-tscaldav

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm link
cd ~/.n8n/nodes
npm link n8n-nodes-tscaldav

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Credits

• Built with ts-caldav by KlautNet
• Developed for the n8n workflow automation platform