icloud integration 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.
Adding Apple iCloud to your Home Assistant instance can be done via the user interface, by using this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
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.
If two-step authentication is enabled for your iCloud account, some time after Home Assistant startup the integration will ask to enter the verification code you receive on your device via a notification in the Home Assistant UI. The duration of this authentication is determined by Apple, so you will need to verify your account every now and then.
Apple allows you to provide an App Specific Password, which don’t require two factor authentication, and one could argue more secure than storing your iCloud password within Home Assistant.
- Sign in to your Apple ID account page.
- In the Security section, click Generate Password below App-Specific Passwords.
- Follow the steps on your screen.
After you generate your app-specific password, enter or paste it into the password field of the integration.
Any time you change or reset your primary Apple ID password, all your app-specific passwords are revoked automatically to protect the security of your account. You’ll need to generate new app-specific passwords for any apps that you want to continue using.
Go into your Home Assistant configuration
.storage folder and delete the “icloud” folder, then retry.
The iCloud integration will track available devices on your iCloud account.
The iCloud integration will add a battery sensor for each iCloud devices available on your iCloud account.
4 services are available:
This service can be used to ask an update of a certain iDevice or all devices linked to an iCloud account. Request will result in new Home Assistant state_changed event describing current iPhone location. It can be used in automations when a manual location update is needed, e.g., to check if anyone is home when a door has been opened.
This service will play the Lost iPhone sound on your iDevice. It will still ring if you are on “Mute” or “Do not disturb” mode.
|Service data attribute||Optional||Description|
||no||E-mail address of the iCloud account|
||no||Human Friendly device name like Bob’s iPhone|
This service will display a message on your iDevice. It can also ring your device.
This service will put your iDevice on “lost” mode (compatible devices only). You have to provide a phone number with a suffixed country code and a message.