Homematic IP
homebridge-homematicip · v2.9.0
Adds Homematic IP thermostats, switches, dimmers, blinds, locks, sensors and security systems to HomeKit.
What it says it supports
Brands
- eQ-3
- Homematic IP
Devices it names
- Homematic IP Access Point
- Home Control Unit
Shows up in Apple Home as from its README
- Lights
- Switches
- Buttons and Remotes
- Thermostats
- Windows and Coverings
- Garage Door Openers
- Locks
- Security Systems
- Sensors
Sensor readings in its code
What people report
Supports a broad range of HomematicIP devices; maintainer adds new models quickly on request (HmIP-RGBW, FSI16, FS6 added in 2026).
- Works6
- Partly works3
The plugin’s own supported-device list
| Device | Status | What they said | Source |
|---|---|---|---|
| HomematicIP HmIP-DLD door lock | Works | Supported with openLatch and PIN optionsSaved copyWelcome to homebridge-homematicip! Configuring per-device options HmIP devices can be configured in the Homebridge UI under Per-device Options. Each entry requires the device's SGTIN, which Apple Home displays as its serial number. The equivalent `config.json` format uses a `devices` array: [code] Enter the SGTIN without dashes and using capital letters. To hide the Home Security System, use the separate `hideSecuritySystem` option shown in the Homebridge UI. Upgrading from a version before 2.8.0? Follow the migration guide before opening the graphical plugin settings. Devices can be removed … Excerpt saved from GitHub on 2026-10-22. | Wiki: Home |
| HomematicIP HmIP-FS6 | Works | Maintainer added support in next versionSaved copyDevice Information Device Name: Homematic IP Schaltaktor für Unterputzmontage – kompakt Model: HmIP-FS6 Device Type: FULL_FLUSH_SWITCH_COMPACT Functionality: 6-channel compact flush-mount switching actuator (on/off). Description Hi! Could you please add support for the new HmIP-FS6 actuator? It is currently not recognized by the plugin. Since it is a standard switching actuator, it should ideally be exposed to HomeKit as a regular switch or light. Log Output [27/08/2026, 17:43:41] [HomematicIP] Device not implemented: HmIP-FS6 - Switch via type FULL_FLUSH_SWITCH_COMPACT Thank you very much … Excerpt saved from GitHub on 2026-10-22. | Issue #622 · 2026-08 |
| HomematicIP HmIP-FSI16 | Works | Fixed with v2.5.0 on HCUSaved copyHi, Would it be possible to add support for the following devices in the future? HmIPW-DRI16 HmIP-RGBW I’m currently using the HmIPW-DRI16 together with reed contacts for wired window and door sensors. The HmIP-FSI16 is already listed as supported. However, when using it with the HCU, I get the following error: [8/3/2026, 3:56:40 PM] [HomematicIP] No functional channels found for device Licht Aufbewahrungsschuppen Carport [8/3/2026, 3:56:40 PM] [HomematicIP] Register accessory: Licht Aufbewahrungsschuppen Carport (3014F711A*) -> uuid -–9-719b1c7fc6d2 Excerpt saved from GitHub on 2026-10-22. | Issue #612 · 2026-08 |
| HomematicIP HmIP-MOD | Works | Listed with device-specific optionsSaved copyWelcome to homebridge-homematicip! Configuring per-device options HmIP devices can be configured in the Homebridge UI under Per-device Options. Each entry requires the device's SGTIN, which Apple Home displays as its serial number. The equivalent `config.json` format uses a `devices` array: [code] Enter the SGTIN without dashes and using capital letters. To hide the Home Security System, use the separate `hideSecuritySystem` option shown in the Homebridge UI. Upgrading from a version before 2.8.0? Follow the migration guide before opening the graphical plugin settings. Devices can be removed … Excerpt saved from GitHub on 2026-10-22. | Wiki: Home |
| HomematicIP HmIP-RGBW | Works | Working as expected after v2.5.0Saved copyHi, Would it be possible to add support for the following devices in the future? HmIPW-DRI16 HmIP-RGBW I’m currently using the HmIPW-DRI16 together with reed contacts for wired window and door sensors. The HmIP-FSI16 is already listed as supported. However, when using it with the HCU, I get the following error: [8/3/2026, 3:56:40 PM] [HomematicIP] No functional channels found for device Licht Aufbewahrungsschuppen Carport [8/3/2026, 3:56:40 PM] [HomematicIP] Register accessory: Licht Aufbewahrungsschuppen Carport (3014F711A*) -> uuid -–9-719b1c7fc6d2 Excerpt saved from GitHub on 2026-10-22. | Issue #612 · 2026-08 |
| HomematicIP HmIP-SRH window handle sensor | Works | Open/tilted/closed shown via window service at 0/50/100%Saved copy… little bit confusing is an status indicator which shouldn't be adjustable. Yes. The plugin is limited to what Apple supports as accessory services. The "window service" is normally used for motor controlled windows (like a roof window), that's why you can manually change the position. You will see that the target position is ignored when looking at the logs. There is not dedicated "status" device which shows more than open/closed. On top the status is shown twice - don't know why? Yes. See issue #60 . I have implemented to services for the window. One contact sensor (with contact / no … Excerpt saved from GitHub on 2026-10-22. | Issue #42 · 2021-02 |
| HomematicIP HmIP-SWDO-I window sensor | Partly works | Showed duplicate contact and window services after v0.3; fix plannedSaved copyI am having the same issue with HmIP-SWDO-I window sensor. I already cleared the homebridge device cache which did not help. I'd prefer to only use the contact sensor or to make it a configurable feature since I can declare a contact sensors as a windows sensor in the home app. Excerpt saved from GitHub on 2026-10-22. | Issue #60 · 2021-02 |
| HomematicIP HmIPW-DRI16 | Partly works | Reed contacts visible after v2.5.0; unused channels also importedSaved copyHi, Would it be possible to add support for the following devices in the future? HmIPW-DRI16 HmIP-RGBW I’m currently using the HmIPW-DRI16 together with reed contacts for wired window and door sensors. The HmIP-FSI16 is already listed as supported. However, when using it with the HCU, I get the following error: [8/3/2026, 3:56:40 PM] [HomematicIP] No functional channels found for device Licht Aufbewahrungsschuppen Carport [8/3/2026, 3:56:40 PM] [HomematicIP] Register accessory: Licht Aufbewahrungsschuppen Carport (3014F711A*) -> uuid -–9-719b1c7fc6d2 Excerpt saved from GitHub on 2026-10-22. | Issue #612 · 2026-08 |
| HomematicIP Home Security System | Partly works | Always added; hiding via hideSecuritySystem option now availableSaved copyHi @MartinDdorf , sorry for the late reply. Yes, you're right. The "Home Security System" is always shown since it's a basic function in the HomematicIP world. But it shouldn't appear in all rooms. You can assign the device to a room (e.g. standard room) and it should only appear there. You can also hide in from your favourites when changing the settings for this device. I will look into it if I check for the presence of the "Security Zone" first. If you don't have a security zone the device definitely is useless. On the other hand, a simple door/window sensor is sufficient for the "Home … Excerpt saved from GitHub on 2026-10-22. | Issue #126 · 2021-05 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local + cloud
Homematic IP Access Point / Home Control Unit with auth token (cloud API)
You’ll need
- Homematic IP Access Point or HCU
- Homebridge 2.2
- Node 24 or 26
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | ^2.2.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^24.0.0 || ^26.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | HomematicIP |
| License | Apache-2.0 |
Community signals
| Downloads a week | 123 |
|---|---|
| Downloads a month | 1,048 |
| GitHub stars | 86 |
| Open issues | 18 |
| Closed issues | 160 |
| Last code push | 2026-10-05 |
| Latest version | 2.9.0 (2026-08-28) |
| First published | 2021-01-11 |
| Releases | 81 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Battery
- ContactSensor
- GarageDoorOpener
- HumiditySensor
- LeakSensor
- LightSensor
- Lightbulb
- LockMechanism
- MotionSensor
- OccupancySensor
- SecuritySystem
- SmokeSensor
- StatelessProgrammableSwitch
- Switch
- TemperatureSensor
- Thermostat
- Valve
- Window
- WindowCovering