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 Calendar, Media source, Presence detection, Sensor and To-do list. 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,668 (0.8 % of the installations that share statistics)
Categories
Calendar, Media source, Presence detection, Sensor, To-do list
Provides
Calendar, Device tracker, Sensor, To-do list
Maintained by
@Quentame, @nzapponi
Python packages
pyicloud==2026.10.1

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

  • Script Find My Apple Device – Locates Apple devices via iCloud and integrates with Alexa for device tracking. ♥ 4 · Import · Forum

All blueprints for it

Known issues and fixes

9 open issues and 17 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 · 6 reactions · 19 comments · #170959
  • open Reported problem #157356 since November 26, 2025 · 4 reactions · 52 comments · #157356
  • open Reported problem #185844 since October 11, 2026 · 0 reactions · 8 comments · #185844
  • open Reported problem #187890 since October 21, 2026 · 0 reactions · 3 comments · #187890
  • open Reported problem #186975 since October 17, 2026 · 0 reactions · 3 comments · #186975
  • open Reported problem #189311 since October 28, 2026 · 0 reactions · 2 comments · #189311
  • open Reported problem #188420 since October 24, 2026 · 0 reactions · 1 comment · #188420
  • open Reported problem #187722 since October 21, 2026 · 0 reactions · 1 comment · #187722

Fixed

Source: the issue tracker of Home Assistant, as of October 29, 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