Homey integration for Home Assistant - Now Available! 🎉

[ifMike]

Hey Homey community!

I’ve been waiting for someone to build a proper Home Assistant integration for Homey… and I got tired of waiting. So I built one myself.

What is this?

A custom Home Assistant integration that discovers and connects your Homey devices and exposes them natively in Home Assistant. No manual configuration, no workarounds—install, configure, and go.

What does it support?

Pretty much everything:

• Lights – Dimming, color (HS), and color temperature
• Switches – On/off control
• Sensors – Temperature, humidity, pressure, power, voltage, current, luminance, CO2, CO, noise, rain, wind, UV, PM2.5/PM10, VOC, AQI, frequency, gas, soil moisture/temperature, energy, and more. Automatically detects all measure_* and meter_* capabilities
• Binary Sensors – Motion, contact, tamper, smoke, CO/CO2 alarms, water leak, battery, gas, fire, panic, burglar, vibration, and more. Automatically detects all boolean capabilities
• Covers – Window coverings and garage doors with position and tilt control
• Climate – Thermostats with target temperature, humidity control, and HVAC modes (OFF, HEAT, COOL, AUTO, HEAT_COOL). Supports custom thermostats like ThermoFloor
• Fans – Speed control
• Locks – Lock state and control
• Media Players – Volume, play/pause, next/prev track, shuffle, repeat, and full metadata support
• Homey Flows – Trigger automations from Home Assistant as button entities or via service calls. Supports Standard and Advanced Flows
• Buttons – Physical device buttons as Button entities for automation triggers
• Select Entities – Automatic creation for enum capabilities (modes, programs, settings, etc.)
• Number Entities – Numeric input controls for settable numeric capabilities
• Text Entities – Editable string capabilities (optional)
• Vacuum Cleaners – Full control with cleaning modes, docking, and status monitoring
• Battery Devices – Battery storage system support
• Lawn Mowers – Gardena and similar lawn mower devices
• Heat Pumps – Full support with operating programs and controls
• Solar Panels – Energy generation monitoring and grid delivery tracking
• Scenes & Moods – Activate Homey scenes and moods directly from Home Assistant
• Device Groups – Support for Homey device groups plugin (any class type)

Cool Features

• Automatic Device Discovery – Add the integration and all devices appear
• Universal Capability Detection – Automatically detects all measure_*, meter_*, and alarm_* capabilities, including unknown ones
• Device Selection – Choose which devices to import during setup, or manage them later via integration options
• Smart Device Grouping – All entities from the same device are grouped together
• Automatic Synchronization – Device name changes, room moves, and deletions sync from Homey
• Room Organization – Devices assigned to Home Assistant Areas based on Homey rooms (user-assigned areas preserved)
• Real-Time Updates – Socket.IO for instant updates (under 1 second when enabled). Falls back to polling (5–10 seconds) when Socket.IO is unavailable
• Robust API Handling – Automatically discovers the correct Homey API endpoints and handles different API structures
• Self-Hosted Server Support – Works with Homey Self-Hosted Server using HTTPS URLs (supports self-signed certificates)
• Energy Dashboard Integration – Compatible with Home Assistant’s Energy dashboard, including currency normalization for price sensors
• Permission Management – Permission checking with graceful degradation; integration works even with limited permissions

---

How do I install it?

1. Create an API key in Homey

• Go to Homey Web App → Settings → API Keys
• Click New API Key
• Give it a name (e.g., “Home Assistant”)
• Grant permissions:
  • Required: View devices (homey.device.readonly), Control devices (homey.device.control), View System (homey.system.readonly) – for Socket.IO real-time updates
  • Recommended: View Zones (homey.zone.readonly), View Flows (homey.flow.readonly), Start Flows (homey.flow.start), View Moods (homey.mood.readonly), Set Moods (homey.mood.set), View Variables (homey.logic.readonly), Variables (homey.logic)
• Tip: Grant full access so you don’t have to create a new key when you add Logic variables, Flows, etc. later
• Copy the API key ( you won’t see it again)

2. Install the integration in Home Assistant

   Option A – HACS (recommended):

   • Install HACS if you haven’t already
   • Go to HACS → Integrations → three dots menu → Custom repositories
   • Add repository: https://github.com/ifMike/homeyHASS (Category: Integration)
   • Search for “Homey” and click Download
   • Restart Home Assistant

   Option B – Manual installation:

   • Download or clone from GitHub: GitHub - ifMike/homeyHASS: A Homey integration for Home Assistant that automatically discovers and connects all your Homey devices, making them available natively in Home Assistant. · GitHub
   • Copy the custom_components/homey folder to your Home Assistant custom_components directory
   • Restart Home Assistant

3. Configure the integration

• Go to Settings → Devices & Services → Add Integration
• Search for “Homey”
• Enter your Homey IP address and API key
• Select devices (optional) – choose which devices to import or import all

4. Done. All devices should appear automatically.

Homey Self Hosted Server Configuration

For Homey Self Hosted Server (SHS), include the port in the host:

• Host format: IP_ADDRESS:PORT (e.g., 192.168.1.100:4859)
• Default HTTP port: 4859

For more details, see the README.

---

For detailed instructions, troubleshooting, and permission requirements, see the GitHub README: GitHub - ifMike/homeyHASS: A Homey integration for Home Assistant that automatically discovers and connects all your Homey devices, making them available natively in Home Assistant. · GitHub

---

Quick heads-up for the older Homey gang: If you’re on Homey (Pro) Early 2016–2019 (no Local API), this integration won’t work.

You can still bridge Homey and Home Assistant using the universal MQTT approach: Tutorial: Pro - How to integrate Home Assistant with Homey

---

Important Notes

This is a work in progress. It works great for me, but I’m just one guy with too much time on his hands. Expect occasional bugs, updates, and the occasional “oops, that broke something” moment.

I wanted to share it because I know others want to bridge Homey and Home Assistant.

Try it out!

If you use Home Assistant and want to connect your Homey devices, give it a try. I’d love to hear:

• What works well
• What doesn’t
• What features you’d like
• Any bugs you find

GitHub: GitHub - ifMike/homeyHASS: A Homey integration for Home Assistant that automatically discovers and connects all your Homey devices, making them available natively in Home Assistant. · GitHub

Feel free to open issues, submit pull requests, or just share your thoughts.

---

P.S. – This is not officially affiliated with Athom or Home Assistant. Just a community project made by someone who got tired of waiting for someone else to build it.

[Peter_Kawa]

Nice work! Although it was possible with MQTT alr.

[Jeroen_Tebbens]

Another app? I use this one.

Home Assistant Community | Homey

[robertklep]

That app is for exposing HA devices to Homey, isnt it?

This new app is for exposing Homey devices to HA (I have no idea why you would not directly add those devices to HA, but hey ).

[Jeroen_Tebbens]

Ah ok. Misinterpreted that. Yeah agreed.

[ifMike]

Thanks. And yes, I know it works through MQTT but I was having so much trouble with the broker/hub/client and had to restart Homey several times. I just thought that there must be an easier way to get the devices to show up.

[ifMike]

For me, HA is not my main smart home controller. I use Homey. But I do have some use for it.
i.e. I have a Shelly Wall Panel XL that has Home Assistant. So I wanted to easily control my Homey devices from that panel.

The reason for this “integration” to even exist is because I’ve been searching for it and I know other people have too. And I know people have struggled with getting MQTT to work.

Also, I actually got Homey Dashboard (full app) to work on the Shelly Wall Display XL. Just some small issues.

[synnc]

How do you manage to put Homey on the Shelly panel?

[ifMike]

[REMOVED MY GUIDE HERE]

I have answered this in another tread so we don’t clutter this one with non related stuff:

Homey Dashboard on Shelly Wall Display XL

[IMG_8764] I got a question in another tread about my image of Homey Dashboard running on the Shelly Wall Display XL. So I thought I try a guide here instead. I’ve tried to remember the steps. But basically you need to enable developer options on the Shelly, enable ADB and open android settings. You always launch the Homey app from the Android settings. The most cumbersome part is to get the right APKS for Homey and SAI. You might need to troubleshoot this, but all-in-all it should work som…

[Peter_Kawa]

@ifMike

I just thought that there must be an easier way to get the devices to show up.

I agree, to get it going with MQTT is quite a bit of work, and damn precise configuration..
When I finally got it working, I decided to add a tutorial here.

When your integration can be added per HACS in the future, it would be very easy, imho, to just about anyone to add Homey devices to HA.

[ifMike]

@Peter_Kawa

When your integration can be added per HACS in the future, it would be very easy, imho, to just about anyone to add Homey devices to HA.

I’ll try to make that happen when I’ve achieved a good enough state on the integration!
Just made a big update based on your feedback, thanks!

A lot of changes were made in the 1.0.1 (maybe should have been a 1.1.0)

CHANGELOG.md

[Undertaker]

I haven’t found the time to install your integration yet. As a Homey/Home Assistant enthusiast, I’m curious to see if your solution can replace my MQTT-HUB and MQTT client combination.
Installation via HACS would also make things much easier for inexperienced users.

[mudasir_ansari]

This is awesome work
Huge thanks for taking the initiative and sharing this with the community. Automatic discovery, room/area mapping, and Homey Flows support are especially impressive — that’s exactly what many of us have been waiting for.

I’ll definitely give it a try and report back with feedback and any issues I find. Really appreciate you being open to feature requests and PRs as well. Great contribution to bridging Homey and Home Assistant

[Undertaker]

I just imported 300 devices from Homey early26. I now have enough to test before I import early23.

As mentioned above, my main goal is to be able to switch off the MQTT hub and the MQTT client. Compared to its usefulness, it consumes a lot of memory. The Mosquitto broker runs in Docker on Home Assistant anyway.
It’s already clear that your programme can handle large installations.

Greetings from Germany

[ifMike]

Another update - 1.0.2

This release adds support for Advanced Flows

Both Standard Flows and Advanced Flows are now discovered automatically and exposed as dashboard buttons, making them equally easy to trigger.

Flows are added as entities in the integration:

How to Test

You can quickly verify this using HA Developer Tools:

1. Go to Developer Tools → Actions

2. Select:

• Action: trigger_flow
• Owner: homey.trigger.flow

3. Run the action with the following payload:

action: homey.trigger_flow
data:
  flow_name: "<your-flow>"

(Flow name matching is case-insensitive.)

- Fixed flow endpoint from /api/manager/flows/flow to /api/manager/flow/flow (singular)
- Added Advanced Flows support via /api/manager/flow/advancedflow endpoint
- Improved flow discovery to fetch both Standard and Advanced Flows
- Added case-insensitive flow name matching
- Updated README with user-friendly permission names matching Homey UI
- Added comprehensive update guide to README

[Undertaker]

Please let me know as soon as the integration is available in HACS. I will then describe to the people in the German forum how to install the integration. I would like to avoid having to manually install the update every time there is a change.

[Vnet]

that is cool. exposing homey devices to HA. personally i do not have a use case yet, as my ha is a simple slave for homey , for its bluetooth and garmin integrations.

[ifMike]

Will do! I’m still troubleshooting stuff so I really want it to be stable first. It’s already working pretty good, but it could be better.

Next update will include fixes and new features. I’ve already implemented a new version on my machine locally. I fixed bugs, and created completely new ones. I just need to test everything to the best of my ability. Hold on… haha

Fixes

1. Humidity conversions — Handles normalized (0-1) and percentage (0-100) values for humidity sensors and climate controls

2. Climate bug — Fixed capabilities used before definition in climate platform initialization

3. Migration buttons — Filtered out internal Homey migration capabilities (button.migrate_v3) from appearing as button entities

New features

1. Scene platform — Homey scenes appear as scene entities in Home Assistant

2. Moods support — Homey moods appear as scene entities (with different icon)

3. Physical device buttons — Physical device buttons (button, button.1, etc.) appear as button entities

4. Number platform — Ready for numeric control capabilities (placeholder for future capabilities)

5. Select platform — Ready for mode/option selection capabilities (placeholder for future capabilities)

6. Flow management services — Added homey.enable_flow and homey.disable_flow services to enable/disable flows

Enhanced features

1. Climate humidity — Added current and target humidity support with proper conversions

2. Sensor capabilities — Added support for noise, rain, wind, UV, PM2.5/PM10, VOC, AQI, frequency, gas, soil moisture/temperature, energy

3. Binary sensor capabilities — Added support for gas, fire, panic, burglar, generic, maintenance alarms, button, vibration

4. Media player metadata — Added artist, album, track, duration, position, shuffle, repeat support

[ifMike]

It’s now available in HACS with 1.1.0 update. I’ve also added HACS instructions to the README.MD.

Changelog:

CHANGELOG.md

Please report any issues you find! Thanks!

[SmartHomePrimer]

Maybe just me. This was working before, but then I saw that you added to HACS so I updated. Now it says it cannot retrieve devices? Anyone else having an issue? I’m on 1.1.0