Nextcloud Calendar icon

Nextcloud Calendar

Verwalten Sie Ihre Kalender und Termine mit Nextcloud CalDAV
Join our community

Actions9

Overview

This node integrates with Nextcloud Calendar via CalDAV to manage calendars and events. Specifically, the "Termin" (Event) resource with the "Get Many" operation allows users to retrieve multiple calendar events within a specified time range from a selected calendar.

Common scenarios where this node is beneficial include:

  • Fetching all upcoming events in a calendar for display or further processing.
  • Synchronizing events between Nextcloud and other systems.
  • Automating workflows based on calendar events within a given date range.

For example, you could use this node to get all events scheduled in the next month from your work calendar and then send reminders or create reports based on those events.

Properties

Name Meaning
Kalender Select a calendar from the list or enter its ID. This determines which calendar's events are fetched.
Start The start datetime for the event search range. Only events starting at or after this time will be retrieved.
Ende The end datetime for the event search range. Only events ending before or at this time will be retrieved.

Output

The output JSON contains an object with the following structure:

{
  "success": true,
  "operation": "getAll",
  "resource": "event",
  "message": "Termine erfolgreich abgerufen",
  "data": {
    "events": [
      {
        "id": "string",
        "title": "string",
        "start": "ISO8601 datetime string",
        "end": "ISO8601 datetime string",
        "description": "string",
        "location": "string",
        "attendees": [
          {
            "email": "string",
            "displayName": "string",
            "role": "string",
            "rsvp": "boolean"
          }
        ]
      }
    ]
  }
}
  • events is an array of event objects parsed from the Nextcloud response.
  • Each event includes typical calendar event fields such as title, start/end times, description, location, and attendees.
  • No binary data output is produced by this operation.

Dependencies

  • Requires connection to a Nextcloud instance with CalDAV calendar support.
  • Needs an API key credential configured in n8n for authenticating with the Nextcloud Calendar API.
  • The node depends on internal helper modules for interacting with Nextcloud and parsing responses.

Troubleshooting

  • No events returned: Ensure the selected calendar exists and contains events within the specified date range.
  • Invalid calendar ID: Verify that the calendar identifier is correct and accessible with the provided credentials.
  • Date range errors: The start date must be before the end date; otherwise, the node may throw an error or return no results.
  • API connectivity issues: Check network access to the Nextcloud server and validity of the API authentication token.
  • Unexpected response format: If Nextcloud returns malformed data, the node might fail to parse events properly.

Links and References

Discussion