Remote Calendar

The Remote calendar integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to read a calendar in Home Assistant for powering automations.

Known limitations

The integration does not provide the ability to connect to an resource that requires authentication or special headers.

Installation instructions

Configuration

To add the Remote Calendar service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Remote Calendar.

  • Follow the instructions on screen to complete the setup.

Please provide the following information to the config flow.

Calendar Name

A name for your calendar, you can choose a name you want. Example: Home Assistant Events

Calendar URL

The URL of the remote calendar. Example: https://calendar.google.com/calendar/ical/p07n98go11onamd08d0kmq6jhs%40group.calendar.google.com/public/basic.ics

Data updates

At the start of the integration, we fetch data from the remote. If the update fails, the integration tries again to fetch the data. After that, the update interval of the calendar is set to every 24 hours.

Defining a custom polling interval

If you want to define a specific interval at which your device is being polled for data, you can disable the default polling interval and create your own polling automation.

To add the automation:

  1. Go to Settings > Devices & services, and select your integration.
  2. On the integration entry, select the .
    • Then, select System options and toggle the button to disable polling. Disable polling for updates
  3. To define your custom polling interval, create an automation.
  4. Save your new automation to poll for data.

Supported functionality

The integration only supports reading a calendar. A calendar entity has a state and attributes that represent the next upcoming event (only). All the events of the calendar can be displayed in the Calendar dashboard.

Calendar Event Automations

Individual Calendar Events are what powers automations such as:

  • Notify me 12 hours before the start of the event named Garbage collection.

See Calendar Automations for an overview, and read more about Calendar Trigger Variables for the available information you can use in a condition or action such as the event summary, description, location and more.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.