Back to the overview

Apple iCloud in Home Assistant

icloud part of Home Assistant since 0.10

Cloud, polling Set up in the user interface

Apple iCloud is an official Home Assistant integration for Media source, Presence detection and Sensor. Works through the manufacturer’s cloud and asks for changes at regular intervals – it depends on the internet connection and the service.

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Cloud, polling – Works through the manufacturer’s cloud and asks for changes at regular intervals – it depends on the internet connection and the service.
Setup
in the user interface
Kind
Hub – several devices through one gateway or account
Installations
5,109 (0.7 % of the installations that share statistics)
Categories
Media source, Presence detection, Sensor
Provides
Device tracker, Sensor
Maintained by
@Quentame, @nzapponi
Python packages
pyicloud==2.6.5

Setup

  1. In Home Assistant open Settings → Devices & services.
  2. Click "Add integration" and search for Apple iCloud.
  3. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Blueprints that use this integration

All blueprints for it

Known issues and fixes

6 open issues and 5 bug fixes in the last twelve months are recorded for Apple iCloud in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.6.3.

Open

  • open Reported problem #170959 since May 17, 2026 · 5 reactions · 18 comments · #170959
  • open Reported problem #157356 since November 26, 2025 · 4 reactions · 50 comments · #157356
  • open Reported problem #166833 since March 30, 2026 · 4 reactions · 10 comments · #166833
  • open Reported problem #172859 since June 2, 2026 · 0 reactions · 3 comments · #172859
  • open Reported problem #181730 since September 9, 2026 · 0 reactions · 1 comment · #181730
  • open Reported problem #178883 since August 12, 2026 · 0 reactions · 1 comment · #178883

Fixed

Source: the issue tracker of Home Assistant, as of September 16, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration

Scroll to Top