CalDav


The caldav platform allows you to connect to your WebDav calendar and generate binary sensors. A different sensor will be created for each individual calendar, or you can specify custom calendars which match a criteria you define (more on that below). These sensors will be on if you have an on going event in that calendar or off if the event is later in time, or if there is no event at all. The WebDav calendar get updated roughly every 10 minutes.

Prerequisites

You need to have a CalDav server and eventually credentials for it. This component was tested against Baikal but any component complying with the RFC4791 should work.

You might need some additional system packages to compile the Python caldav library. On a Debian based system, install them by:

$ sudo apt-get install libxml2-dev libxslt1-dev zlib1g-dev

Basic Setup

To integrate a WebDav calendar in Home Assistant, add the following section to your configuration.yaml file:

# Example configuration.yaml entry
calendar:
  - platform: caldav
    url: https://baikal.my-server.net/cal.php/calendars/[email protected]/default

Configuration Variables

url

(string)(Required)The full URL to your calendars.

username

(string)(Optional)Username for authentication.

password

(string)(Optional)Password for authentication.

calendars

(list)(Optional)List of the calendars to filter. Empty or absent means no filtering.

custom_calendars

(list)(Optional)Details on any custom binary sensor calendars you want to create.

name

(string)(Required)The name of your custom calendar.

calendar

(string)(Required)The source calendar to search on.

search

(string)(Required)

Sensor attributes

  • offset_reached: If set in the event title and parsed out will be on/off once the offset in the title in minutes is reached. So the title Very important meeting !!-10 would trigger this attribute to be on 10 minutes before the event starts.
  • all_day: True/False if this is an all day event. Will be False if there is no event found.
  • message: The event title with the search values extracted. So in the above example for offset_reached the message would be set to Very important meeting
  • description: The event description.
  • location: The event Location.
  • start_time: Start time of event.
  • end_time: End time of event.

Sensor attributes

# Example configuration.yaml entry
calendar:
  - platform: caldav
    url: https://baikal.my-server.net/cal.php/calendars/[email protected]/default
    username: [email protected]
    password: !secret caldav
    custom_calendars:
      - name: 'HomeOffice'
        calendar: 'Agenda'
        search: 'HomeOffice'