Skip to content
Homebridge TestFlight
eQ-3, Homematic IP

Homematic IP

homebridge-homematicip · v2.9.0

Local + cloudHomebridge 2.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

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

DeviceStatusWhat they saidSource
HomematicIP HmIP-DLD door lockWorksSupported with openLatch and PIN options
Saved copy
Welcome 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-FS6WorksMaintainer added support in next version
Saved copy
Device 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-FSI16WorksFixed with v2.5.0 on HCU
Saved copy
Hi, 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-MODWorksListed with device-specific options
Saved copy
Welcome 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-RGBWWorksWorking as expected after v2.5.0
Saved copy
Hi, 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 sensorWorksOpen/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 sensorPartly worksShowed duplicate contact and window services after v0.3; fix planned
Saved copy
I 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-DRI16Partly worksReed contacts visible after v2.5.0; unused channels also imported
Saved copy
Hi, 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 SystemPartly worksAlways added; hiding via hideSecuritySystem option now available
Saved copy
Hi @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 HomebridgeNo
Homebridge versions^2.2.0
Homebridge 2.0Yes
Node.js^24.0.0 || ^26.0.0
Settings in Homebridge UIYes
MatterNo
Platform nameHomematicIP
LicenseApache-2.0

Community signals

Downloads a week123
Downloads a month1,048
GitHub stars86
Open issues18
Closed issues160
Last code push2026-10-05
Latest version2.9.0 (2026-08-28)
First published2021-01-11
Releases81

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