How to Integrate Philips Hue with Home Assistant

Philips Hue is one of the most popular smart lighting ecosystems in the world — and for good reason. The bulbs are reliable, the colour reproduction is excellent, and the ecosystem is enormous. But if you're running Home Assistant, you can take your Hue setup far beyond what the official app allows.

With Home Assistant's native Philips Hue integration, you get full local control, deep automation capabilities, and the ability to combine your Hue lights with every other device in your home. This guide walks you through the entire setup process from scratch.

Why Integrate Hue with Home Assistant?

The Philips Hue app is decent, but it has real limitations. You're tied to Hue-specific scenes, Hue schedules, and Hue accessories. When you bring Hue into Home Assistant, those walls disappear.

• Local control: The integration communicates directly with your Hue Bridge — no cloud needed.
• Cross-device automations: Trigger Hue lights based on your motion sensors, door locks, robot vacuum, or anything else in HA.
• Scenes at scale: Apply your Hue scenes to complex multi-room automations instantly.
• Diagnostics: Monitor bulb state, brightness levels, and colour temperature in real time.
• Entertainment areas: Use Hue Entertainment groups for sync with other HA automations.

Prerequisites

Before you start, make sure you have:

• Home Assistant OS, Supervised, or Core (2023.9 or later recommended)
• Philips Hue Bridge V2 connected to your local network
• At least one Hue bulb or device paired to the bridge
• The Hue Bridge and your HA server on the same network (or routable VLANs)

Setting Up the Integration

Home Assistant ships with a built-in Philips Hue integration — no HACS required. Here's how to add it:

Step 1: Open Integrations

Navigate to Settings → Devices & Services → Add Integration. Search for "Philips Hue" and select it.

Step 2: Discovery

Home Assistant will automatically scan your network for Hue Bridges. If found, it will display the bridge's IP address. Click on it to proceed. If not found, you can enter the IP address manually.

Step 3: Press the Bridge Button

You'll be prompted to press the physical button on top of your Hue Bridge. This authenticates Home Assistant with the bridge. Press the button, then click "Submit" in HA within 30 seconds.

Step 4: Assign to Area

Once connected, HA will import all your Hue lights, scenes, and accessories. You can assign devices to areas during or after setup.

Step 5: Verify Entities

Go to Settings → Devices & Services → Philips Hue. You should see your bridge listed as a device, with all bulbs and accessories as entities beneath it.

Local Polling vs Push

The Hue integration in Home Assistant uses the Hue API v2 (SSE/push-based) by default on recent versions. This means state changes in the Hue app — like turning a light on with a Hue dimmer switch — are reflected in Home Assistant almost instantly.

Older setups using API v1 relied on polling every few seconds. If you're on a recent HA version, you're already on the better v2 API. You can confirm by checking the integration's details page — it should say "API v2".

Building Automations

Now the fun begins. Here are some practical automation ideas to get you started:

Motion-Activated Lighting

Use any motion sensor (Hue, Zigbee, or anything else paired to HA) to trigger your Hue lights. In the Automation editor, set your trigger as the motion sensor state changing to "detected", and set the action to call light.turn_on with your desired scene or brightness.

Sunrise/Sunset Scenes

Automate your Hue lights to shift colour temperature throughout the day. Use the Sun integration's sun elevation as a condition, and call different Hue scenes at different times.

Adaptive Lighting

Install the Adaptive Lighting HACS integration to automatically adjust your Hue lights' colour temperature and brightness in sync with the sun. It's one of the most popular HA automations and works beautifully with Hue bulbs.

Presence-Based Control

Combine Hue lighting with your phone's location (using the HA companion app) to automatically turn lights on when you arrive home and off when you leave.

Advanced Tips

Hue Scenes in HA

All your Hue scenes sync to Home Assistant and appear as scene entities. You can call them directly in automations using scene.turn_on. This means you can trigger your custom Hue scenes — including dynamic ones — from any HA automation.

Hue Entertainment

Home Assistant can activate Hue Entertainment areas, which puts the bridge into a low-latency streaming mode. This is primarily useful if you're building a media sync setup.

Using Hue Accessories in HA

Hue dimmer switches and tap dials are imported as devices with button entities. You can use these button presses as triggers in HA automations, giving you far more flexibility than the Hue app allows — like triggering a complete home scene from a single button press.

Matter Integration

Newer Hue bulbs support Matter, meaning you can pair them directly to Home Assistant without a Bridge. This is useful for simpler setups but loses some Hue-specific features like Entertainment and some scenes.

Troubleshooting

Bridge Not Found

Make sure your Hue Bridge is on the same network as Home Assistant, or that routing between VLANs is configured. You can find the Bridge IP in the Hue app under Settings → My Hue system → Hue Bridges.

Entities Not Updating

If using API v2, this is usually a network issue. Check that port 443 is reachable from HA to the bridge. Restart the integration from the Integrations page if needed.

Missing Devices

New bulbs added to Hue after the integration was set up should appear automatically. If they don't, reload the integration via the three-dot menu on the integration card.

SmartWired participates in the Amazon Associates Programme. We may earn a commission from qualifying purchases at no extra cost to you.