Overview
This node connects n8n to a CalDAV server and allows you to retrieve multiple events from a specified calendar within a given time range. It is useful for automating workflows that need to access, process, or synchronize calendar events—such as sending reminders, aggregating schedules, or integrating with other scheduling tools.
Example scenarios:
- Fetching all upcoming meetings from a team calendar for the next month.
- Syncing events between a CalDAV calendar and another system (e.g., Google Calendar).
- Generating daily or weekly event summaries.
Properties
| Name | Type | Meaning |
|---|---|---|
| Calendar | options | The calendar to fetch events from. This is required and selectable from available calendars on the CalDAV server. |
| Start | dateTime | The lower bound of the time range to get events for. Defaults to the current date and time. |
| End | dateTime | The upper bound of the time range to get events for. Defaults to 30 days from now. |
Output
The node outputs an array of objects, each representing an event fetched from the selected calendar. Each output item has a json field containing the event's data as returned by the CalDAV server. The exact structure of the event object depends on the CalDAV implementation but typically includes fields such as event summary, start/end times, description, and attendees.
Example output:
[
{
"json": {
"id": "event-123",
"summary": "Team Meeting",
"start": "2024-07-01T10:00:00Z",
"end": "2024-07-01T11:00:00Z",
"description": "Monthly sync-up",
"attendees": ["alice@example.com", "bob@example.com"]
// ...other event fields
}
},
// more events...
]
Dependencies
- CalDAV Server: You must have access to a CalDAV-compatible calendar server.
- Credentials: Requires n8n credentials of type
calDavBasicAuth(username and password for the CalDAV server).
Troubleshooting
- Invalid Credentials: If authentication fails, ensure your CalDAV username and password are correct in the n8n credentials.
- Calendar Not Found: If the specified calendar does not exist or is misspelled, no events will be returned. Use the dropdown to select valid calendars.
- Date Range Issues: If the start date is after the end date, or if dates are malformed, the node may return no results or throw an error.
- Connection Errors: Network issues or incorrect CalDAV server URLs can cause connection failures.
Common error messages:
"Authentication failed": Check your credentials."Calendar not found": Verify the calendar name."Invalid date format": Ensure the Start and End properties are valid ISO date strings.