Shelly

Shelly Matter

homebridge-shelly-matter · v0.10.1

VerifiedLocalMatterHomebridge 2.0

Exposes Shelly relays, plugs, dimmers and shutters to Apple Home over Matter with live power and energy metering.

View on npm Source code

What it says it supports

Brands

Shelly

Devices it names

Shelly Plus/Pro 1
Shelly Plus/Pro 1PM
Shelly Plus/Pro 2PM
Shelly Pro 4PM
Shelly Plus Plug S
Shelly 1
Shelly 2.5
Shelly Dimmer 2
Shelly Pro Dimmer 1PM
Shelly Dimmer Gen4
Shelly Plus Shutter
Shelly Plus Wall Dimmer

Shows up in Apple Home as from its README

What people report

Maintainer adds Shelly models quickly on request; Gen4 EM and Pro Dimmer reports were fixed. Power metering in Apple Home needs iOS 27.

Works2

Device	Status	What they said	Source
Shelly EM Gen4	Works	Support added in v0.7.0-beta.1 as outlet with power metering; metering needs iOS 27 Saved copy Thanks! Here are the four full API responses from my Shelly EM Gen4. Device: Model: S4EM-002CXCEU Generation: 4 Firmware: 2.0.0 App: EMG4 Device name: Comptador I have redacted the Wi-Fi SSID, BSSID, MAC addresses, IPv6 address, local IP address and geographic coordinates for privacy. Otherwise, the API responses are complete and unchanged. 1. `http://device-ip/shelly` ```json { "name": "Comptador", "id": "shellyemg4-XXXXXXXXXXXX", "mac": "AA:BB:CC:DD:EE:FF", "slot": 1, "model": "S4EM-002CXCEU", "gen": 4, "fw_id": "20260710-101116/2.0.0-g87fbfa4", "ver": "2.0.0", "app": "EMG4", "auth_en": … Excerpt saved from GitHub on 2026-10-22.	Issue #7 · 2026-08
Shelly Pro Dimmer 1 PM	Works	Fixed after report: turn-on via brightness and wrong brightness display Saved copy Yes, it does turn on with Homebridge UI tile with the update. Also for the hardware I can confirm that Shelly Pro Dimmer 1 PM and Shelly Dimmer Gen4 both working flawlessly. I found that the Shelly matter support for Shelly Dimmer Gen4 power monitoring does't seem to reflect correctly at Apple Home, therefore I converted to use your plugin instead. Thank for your hardwork! Excerpt saved from GitHub on 2026-10-22.	Issue #24 · 2026-10

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

Shelly native local protocol (Gen 1 via CoIoT) exposed as Matter

You’ll need

Homebridge 2.3.0+ with Matter enabled
Node.js 22.12+
iOS/tvOS 27+ for energy data

Compatibility

Verified by Homebridge	Yes
Homebridge versions	>=2.3.0 <3.0.0
Homebridge 2.0	Yes
Node.js	^22.12.0 \|\| ^24.0.0 \|\| ^26.0.0
Settings in Homebridge UI	Yes
Matter	Yes (uses the Homebridge 2 Matter API)
Platform name	ShellyMatter
License	Apache-2.0

Community signals

Downloads a week	642
Downloads a month	2,616
GitHub stars	6
Open issues	1
Closed issues	20
Last code push	2026-10-18
Latest version	0.10.1 (2026-10-18)
First published	2026-07-23
Releases	56

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.