Sensors

Calendar Sensor

The status of the calendar sensor indicates (on/off) whether there is an event on at the current time. The message, all_day, start_time, end_time, location, and description attributes provide details of the current or next event. A non-all-day event is favoured over all_day events.

The data attribute provides an array of events for the period defined by the start_offset and end_offset in ms365_calendars_<entity_name>.yaml. Individual array elements can be accessed using the template notation states.calendar.<entity_name>_calendar.attributes.data[0...n].

Each event in data also has these read-only fields from MS Graph. What their values mean is in the Microsoft Graph documentation of the location and event resources:

• locations - each place of the event, one item for an event in one place, with its name and MS Graph’s type, plus the address, coordinates, email and uri when they are filled in; left out for an event without a place
• online_meeting - the provider and join_url of an online meeting, such as a Teams meeting; left out for any other event
• web_link - the link that opens the event in Outlook on the web