Overview
CalDAV Full is a custom Home Assistant integration from Grovik LLC. It connects to a CalDAV account, lists calendar collections, and exposes only the collections you confirm.
It is a separate integration. It does not replace or modify Home Assistant’s built-in CalDAV integration. It works with calendar events. It does not provide to-do lists.
The published release is version 0.1.5. Release notes
Requirements and compatibility
- Home Assistant Core 2026.10.0 or newer.
- Python 3.14.2 or newer, matching that Core release.
- Network access to the CalDAV server.
The integration requires these minimum supported library versions:
caldav>=3.3.0a1icalendar>=6.3.1vobject>=0.9.9
Do not install it on an older Home Assistant Core release. These minimum versions match the libraries shipped with Home Assistant Core 2026.10.0. Compatibility with other Core versions is not established.
Calendar servers
Isolated tests covered discovery, single-event changes, one occurrence, whole-series text, and whole-series deletion.
- Apple iCloud CalendarValidated
- Nextcloud CalendarValidated
- BaïkalValidated
- Radicale 3.8.3Validated
- SOGo 5.12.12Partially compatible
- Synology CalendarNot tested
Apple spring-forward occurrence handling was not live-validated. Production Apple acceptance covered sign-in and single-event create, edit, delete, and sync.
SOGo 5.12.12 completed the tested operations when the ETag was current. A stale If-Match on PUT returns a conflict. DELETE ignores If-Match, including a stale, unknown, or malformed tag, and still removes the object. SOGo is not fully supported for safe concurrent deletion.
Installation
Install version 0.1.5 from the public repository as a HACS custom repository. CalDAV Full is not in the HACS default store, and this website does not host the download.
- In HACS, add
https://github.com/Grovik-LLC/caldav-fullas a custom repository of type Integration, then download CalDAV Full. - Restart Home Assistant.
- Go to Settings, Devices & services, Add integration, and choose CalDAV Full.
You can also copy custom_components/caldav_full into the Home Assistant config/custom_components directory, then restart and add the integration.
Configuration
The setup form asks for:
- CalDAV URL
- Username
- Password
- Whether to verify the SSL certificate
For Apple iCloud, enter an app-specific password. The account needs two-factor authentication. Apple’s steps are at support.apple.com/en-us/102654. Other CalDAV servers use their own password.
After sign-in, CalDAV Full lists calendar names. A new setup starts with nothing selected. Newly discovered calendars stay unselected. A checked calendar is not activated until the confirmation step. Closing the dialog does not save.
- Continue with no calendars. CalDAV Full creates no calendar entity. It can still sign in and list calendar names.
- Activate selected calendars. Each selected collection becomes a calendar entity. That entity can create, update, and delete events, within the operations this integration supports.
The same confirmation is required when you change the selection later. Clearing every box and confirming removes the exposed calendars.
If the same account is already configured, setup stops with “Account is already configured.” If the stored password is no longer valid, Home Assistant asks for that username’s password again.
Calendar operations
For a calendar you have confirmed, CalDAV Full can:
- Read events, including all-day events, timed events, and expanded occurrences of a supported series.
- Create an event. A create can include one recurrence rule, which creates a new series. A create can also include a description and a location.
- Update or delete one non-recurring event. The write uses that event’s ETag, so a change is sent only when the stored copy still matches.
- Change the title, description, and location of a whole series. The start, end, and repeat rule are left as stored.
- Delete one whole series with a single conditional delete.
A selected calendar polls for the next event about every 15 minutes. Opening a date range reads that range from the server.
Home Assistant still shows create, update, and delete for the calendar entity. Requests outside the supported operations fail when they are made. There is no separate read-only mode.
Recurring events
Supported
- Create a series by including one recurrence rule on a new event.
- Update one occurrence of a supported series. CalDAV Full writes an override for that occurrence’s original start.
- Exclude one occurrence of a supported series. CalDAV Full writes an exclusion and keeps the rest of the series.
- Change the title, description, and location of a whole series. An omitted description or location is left unchanged. An explicit empty value clears that field.
- Delete a whole series.
Home Assistant’s built-in calendar editor does not expose whole-series editing or deletion. That screen offers “Only this event” and “This and all future events.” Use the editor for one occurrence. Whole-series title, description, location, and deletion are available to clients that send a series-level update or delete without a recurrence range. Family Calendar Card v3.1.3 was checked only for one non-recurring create, title and location edit, and delete. Recurring operations on that card were not tested.
Not supported
These requests are rejected before the stored series is changed:
- Moving a series, or changing its duration.
- Changing the repeat rule, including how many times it repeats or when it ends.
- A
THISANDFUTUREchange, which would apply to one occurrence and the occurrences after it. - Adding or changing a recurrence rule on an existing non-recurring event.
- A series with more than one
RRULE. - An
EXRULE. - A period
RDATE. - Updating or deleting an occurrence when the event itself stores an
RDATE.
A normal date or date-time RDATE can still be expanded when events are read. That read does not make the series editable.
Known limitations
- Moving a series, changing its duration or repeat rule, and
THISANDFUTUREchanges are not supported. Title, description, location, and deletion of a whole series are supported, but the built-in calendar editor does not offer them. - To-do lists, YAML setup, and custom search calendars are not included.
- An update cannot turn a non-recurring event into a recurring series.
- A recurring occurrence that crosses the spring-forward clock change has not been live-validated.
- Recorded evidence can show that time-zone data is present. It does not prove that every time-zone line is preserved byte for byte.
- An Apple event can be found under the observed
{uid}.icsname. That name is not guaranteed on every CalDAV server. - The calendar entity advertises create, update, and delete. A request to move a series, change its rule, or apply “this and all future events” is rejected when it is made.
Troubleshooting
These are conditions the integration already reports. They are not provider-specific repair steps.
Setup
- Failed to connect. Home Assistant could not reach the CalDAV server. A timeout or connection error raises the same kind of failure while the integration starts.
- Invalid authentication. The username or password was not accepted. A later read can report CalDAV authentication failed. A later write can report CalDAV update authentication failed or CalDAV delete authentication failed.
- Unexpected error. Setup hit an error that is not a connection or authentication failure.
- Account is already configured. That CalDAV account is already set up.
Changes that are refused
For the cases below, the integration raises an error and does not write the rejected change:
- Recurring event changes are not supported for this calendar. This covers a
THISANDFUTUREchange, an unsupported series shape, and an attempt to add a recurrence rule to an existing event. - Changing the time of a whole series is not supported yet. A series-level update included a start or end that does not match a displayed occurrence.
- Start must stay a timed value or End must stay a timed value. Start must stay an all-day date or End must stay an all-day date. An all-day event cannot be changed into a timed event, or the reverse, through this integration.
- Start time zone does not match the stored event or End time zone does not match the stored event.
- Calendar event end must be after its start.
Events that cannot be changed safely
- Calendar event {uid} was not found. The requested event is not on the server. A missing event is not created in its place.
- Calendar event {uid} is ambiguous. More than one stored object matches that event.
- Calendar event {uid} is outside the selected calendar. The event resource is not inside the confirmed collection. A redirect away from that collection is reported the same way.
- Calendar event {uid} cannot be changed safely without an ETag. The server did not provide an ETag for the event, so the conditional write stops.
- CalDAV update conflict: the event changed on the server or CalDAV delete conflict: the event changed on the server. The stored event no longer matches the copy that was read.
Frequently asked questions
Is this Home Assistant’s built-in CalDAV integration?
No. CalDAV Full is a separate custom integration. It does not replace or modify the built-in integration.
Can I install it from HACS or GitHub?
Add the public repository as a HACS custom repository, then download version 0.1.5. It is not in the HACS default store. This site does not host the files. The release is at github.com/Grovik-LLC/caldav-full/releases/tag/0.1.5.
What if I leave every calendar unselected?
Confirming that choice creates no calendar entity. The integration can still sign in and list calendar names. Newly discovered calendars stay unselected until you confirm them.
Can I edit or delete a whole recurring series?
You can change the title, description, and location, or delete the series. The built-in calendar editor does not show those choices. Moving the series, changing its duration or repeat rule, and “this and all future events” are rejected and do not change the stored series.
Does it support to-do lists?
No.
Support
Questions and defect reports: contact@grovik.co
Public issue tracker: github.com/Grovik-LLC/caldav-full/issues
