Quick Answer

Via Hue Bridge: Easiest, fully local, keeps Hue app working. Add the Hue integration in HA, press the bridge button, done. Via Zigbee2MQTT: No bridge needed, more attributes exposed, but Hue bulbs leave your Hue ecosystem. Choose the bridge approach unless you're replacing the Hue hub entirely.

Table of Contents

  1. Two Approaches
  2. Bridge Setup
  3. Zigbee2MQTT Approach (No Bridge)
  4. Presence-Based Lighting (YAML)
  5. Group Control
  6. Troubleshooting
  7. FAQ

What You Need

Two Approaches

Hue bulbs are Zigbee devices at their core. You can control them two ways:

  1. Via Hue Bridge: Keep using the Hue Bridge as the Zigbee coordinator for your bulbs. HA connects to the bridge via its local REST API (no cloud). You keep the Hue app, Hue scenes, and Hue-native features.
  2. Via Zigbee2MQTT (no bridge): Pair Hue bulbs directly to your Zigbee2MQTT coordinator. The Hue Bridge is no longer involved. You lose Hue app control and Hue scenes, but gain direct device control and more attributes.

The Right Choice for Most People

Keep your Hue Bridge. The HA-Hue bridge integration is excellent — fully local, reliable, and preserves your existing Hue setup. Only abandon the bridge if you want to consolidate everything onto one Zigbee coordinator.

Hue Bridge Setup in HA

  1. Ensure your Hue Bridge is powered on and on the same network as HA
  2. HA usually auto-discovers the bridge — check Settings → Integrations for a "Philips Hue" banner
  3. Click Configure → press the round button on top of the Hue Bridge within 30 seconds
  4. HA links to the bridge — all lights, groups, and scenes appear as entities

HA communicates with the bridge via its local REST API (port 80/443). No Philips cloud servers are involved once set up.

Entities you'll get:

Zigbee2MQTT Approach (No Bridge)

To pair Hue bulbs directly with Zigbee2MQTT:

  1. Factory reset each Hue bulb (turn on/off 5 times quickly, or use the Hue app's "reset" option)
  2. Enable Permit Join in Zigbee2MQTT
  3. Put the bulb near your coordinator — it should pair automatically
  4. Rename it in Z2M and it appears in HA
Warning: Once you move Hue bulbs to Zigbee2MQTT, they leave the Hue Bridge's network. You can't use the Hue app or Hue dimmer switches to control them anymore (the switches would need to be re-paired too). This is a one-way migration.

Presence-Based Lighting (YAML)

automations.yaml — Adaptive lighting based on time of day
automation:
  - alias: "Living room adaptive lighting"
    description: "Adjust Hue lights based on time and presence"
    trigger:
      - platform: state
        entity_id: binary_sensor.living_room_motion
        to: "on"
    action:
      - choose:
          - conditions:
              - condition: time
                after: "07:00:00"
                before: "12:00:00"
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.living_room
                data:
                  brightness_pct: 100
                  color_temp: 6500
          - conditions:
              - condition: time
                after: "12:00:00"
                before: "18:00:00"
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.living_room
                data:
                  brightness_pct: 80
                  color_temp: 4000
          - conditions:
              - condition: time
                after: "18:00:00"
                before: "23:00:00"
            sequence:
              - service: light.turn_on
                target:
                  entity_id: light.living_room
                data:
                  brightness_pct: 40
                  color_temp: 2700

Group Control

Use HA's light groups to control multiple Hue lights together, regardless of whether they're on the bridge or Zigbee2MQTT:

configuration.yaml — Light group
light:
  - platform: group
    name: "Living Room All"
    entities:
      - light.sofa_lamp
      - light.ceiling_1
      - light.ceiling_2
      - light.floor_lamp

Troubleshooting

FAQ

Does HA's Hue integration need the Hue cloud?

No — HA uses the Hue Bridge's local REST API. The bridge itself may phone home to Philips for firmware updates, but HA-Hue communication is 100% local.

Can I use Hue dimmer switches in Home Assistant automations?

Yes — Hue dimmer switches appear as devices in HA (via the Hue bridge integration) and expose button events. You can use them as automation triggers for anything in HA, not just Hue lights.

Do Hue scenes work in Home Assistant?

Yes — if using the bridge integration, your Hue scenes appear as HA scene entities and can be activated in automations with the scene.turn_on service.

SmartWired uses affiliate links. If you buy through our links, we may earn a commission at no extra cost to you. See our Affiliate Disclosure.