2026.6.4
Home ▸ Integrations

Apple iCloud

The Apple iCloud integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to detect presence using the iCloud service. iCloud allows users to track their location on iOS devices.

There is currently support for the following platforms within Home Assistant:

It does require that your devices are registered with the Find My service.

Configuration

To add the Apple iCloud hub 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 Apple iCloud.

  • Follow the instructions on screen to complete the setup.

Warning

You may receive recurring emails and notifications from Apple stating that someone has logged into your account if the integration is improperly configured. If this occurs, select Don't Allow on your iOS device and reconfigure the Integration Credentials when prompted.

For the notification, press “Allow”, then “OK”.

To prevent excessive battery drainage, a dynamic interval is used for each individual device instead of a fixed interval for all devices linked to one account. The dynamic interval is based on the current zone of a device, the distance towards home and the battery level of the device.

Two Factor Authentication

Important

You need to use an app-specific password to set up this integration.

In case of troubleshooting

Delete the integration’s configuration (most likely in /config/.storage/icloud), then retry.

Platforms

Device tracker

The iCloud integration will track available devices on your iCloud account.

Sensor

The iCloud integration will add a battery sensor for each iCloud devices available on your iCloud account.

List of actions

The Apple iCloud integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

  • Display message (icloud.display_message) Displays a message on an Apple device.

  • Lost device (icloud.lost_device) Puts an Apple device into Lost Mode.

  • Play sound (icloud.play_sound) Plays the Lost device sound on an Apple device.

  • Update (icloud.update) Requests a location and state update for the devices on an Apple Account.

For an overview of every action across all integrations, see the actions reference.