Philips Hue in Home Assistant

hue part of Home Assistant since 0.60

Local, push Set up in the user interface

Philips Hue is an official Home Assistant integration for Hub and Light. Talks to the device on your own network and is told about every change straight away.

Compatible with Home Assistant: yes, official integration
Connection: Local, push – Talks to the device on your own network and is told about every change straight away.
Setup: in the user interface
Kind: Hub – several devices through one gateway or account
Installations: 86,417 (12.6 % of the installations that share statistics)
Categories: Hub, Light
Provides: Binary sensor, Diagnostics, Event, Light, Scene, Sensor, Switch
Found automatically via: Network discovery (Zeroconf), HomeKit pairing
Maintained by: @marcelveldt
Python packages: aiohue==4.9.0

Setup

Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
In Home Assistant open Settings → Devices & services.
Click "Add integration" and search for Philips Hue.
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

Automation Hue Dimmer Remote With Hold ♥ 27 · Import · Forum
Automation Philips Hue Tap Dial Audio + Light ♥ 3 · Import · Forum
Automation Philips Hue Tap Dial - Media Controls (Native Hue Hub) ♥ 3 · Import · Forum
Automation Motion-activated Light with illuminance v2 ♥ 2 · Import · Forum
Automation Hue Scene Refresher (v2.11) ♥ 1 · Import · Forum
Automation Adaptive Hue Wall Switch Scene Cycler ♥ 1 · Import · Forum

All blueprints for it

Known issues and fixes

10 open issues and 16 bug fixes in the last twelve months are recorded for Philips Hue in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.8.0.

Open

open Reported problem #181632 since September 8, 2026 · 1 reaction · 3 comments · #181632
open Reported problem #181440 since September 6, 2026 · 1 reaction · 2 comments · #181440
open Reported problem #178397 since August 6, 2026 · 0 reactions · 15 comments · #178397
open Reported problem #166137 since March 21, 2026 · 0 reactions · 8 comments · #166137
open Reported problem #178564 since August 8, 2026 · 0 reactions · 6 comments · #178564
open Reported problem #174857 since June 25, 2026 · 0 reactions · 4 comments · #174857
open Reported problem #181925 since September 11, 2026 · 0 reactions · 2 comments · #181925
open Reported problem #181168 since September 3, 2026 · 0 reactions · 2 comments · #181168

Fixed

fixed in 2026.8.0 Bug fix #177691 Fix #177691 · Issue #131983
fixed in 2026.8.0 Bug fix #177653 Fix #177653
fixed in 2026.8.0 Bug fix #177427 Fix #177427 · Issue #156390
fixed in 2026.8.0 Bug fix #177643 Fix #177643 · Issue #168297
fixed in 2026.8.0 Bug fix #177671 Fix #177671
fixed in 2026.8.0 Bug fix #177874 Fix #177874
fixed in 2026.6.4 Bug fix #173747 Fix #173747 · Issue #171713
fixed in 2026.6.3 Bug fix #173532 Fix #173532 · Issue #173475
fixed in 2026.6.3 Bug fix #173536 Fix #173536 · Issue #173528
fixed in 2026.6.0 Bug fix #172535 Fix #172535 · Issue #172519
fixed in 2026.6.0 Bug fix #172442 Fix #172442 · Issue #116258
fixed in 2026.5.4 Bug fix #171844 Fix #171844 · Issue #152937

Source: the issue tracker of Home Assistant, as of September 13, 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 →

Compatible devices

Devices that work with Philips Hue

Source of this entry: the official documentation of the integration

Facts about this integration