matterbridge-homeconnect-fridge

A Matterbridge plugin that reads a Bosch Home Connect fridge/freezer from Home Assistant and exposes it as a Matter 1.2 Refrigerator device.

Features

• Exposes a Home Connect FridgeFreezer appliance as a Matter Refrigerator device (device type 0x0070)
• Two child endpoints: Refrigerator compartment and Freezer compartment (device type 0x0071)
• Real-time temperature updates via Home Assistant WebSocket API
• Door open/close state with RefrigeratorAlarm cluster
• Temperature setpoint tracking for both compartments
• Auto-reconnect to Home Assistant on connection loss

Prerequisites

• Matterbridge >= 3.6.0
• Home Assistant with the Home Connect integration configured
• A long-lived access token from Home Assistant

Installation

matterbridge -add matterbridge-homeconnect-fridge

Or install manually:

cd matterbridge-homeconnect-fridge
npm install
npm run build

Configuration

Configure the plugin in the Matterbridge UI or edit the config JSON directly:

| Parameter | Required | Description | Example | |---|---|---|---| | haUrl | Yes | Home Assistant URL | http://192.168.1.100:8123 | | haToken | Yes | HA long-lived access token | eyJhbGciOi... | | fridgeTempEntity | Yes | Fridge temperature sensor entity | sensor.fridgefreezer_refrigerator_temperature | | freezerTempEntity | Yes | Freezer temperature sensor entity | sensor.fridgefreezer_freezer_temperature | | fridgeDoorEntity | Yes | Fridge door binary sensor entity | binary_sensor.fridgefreezer_refrigerator_door | | freezerDoorEntity | Yes | Freezer door binary sensor entity | binary_sensor.fridgefreezer_freezer_door | | fridgeSetpointEntity | No | Fridge setpoint entity | number.fridgefreezer_refrigerator_setpoint | | freezerSetpointEntity | No | Freezer setpoint entity | number.fridgefreezer_freezer_setpoint |

Finding your entity IDs

1. Open Home Assistant → Settings → Devices & Services → Home Connect
2. Click on your fridge/freezer device
3. Note the entity IDs for temperature sensors, door sensors, etc.

Typical Bosch Home Connect entity patterns:

• sensor.<device>_refrigerator_temperature
• sensor.<device>_freezer_temperature
• binary_sensor.<device>_refrigerator_door
• binary_sensor.<device>_freezer_door

Getting a Home Assistant access token

1. Open Home Assistant → click your profile (bottom-left)
2. Scroll to Long-Lived Access Tokens
3. Click Create Token, give it a name, and copy the token

Matter Device Structure

Refrigerator (0x0070)
├── Identify Cluster
├── BridgedDeviceBasicInformation Cluster
├── PowerSource Cluster (Wired)
├── RefrigeratorAndTemperatureControlledCabinetMode Cluster
├── RefrigeratorAlarm Cluster (door state)
│
├── Refrigerator Cabinet (0x0071) [tag: Refrigerator]
│   ├── TemperatureControl Cluster (setpoint)
│   ├── TemperatureMeasurement Cluster (current temp)
│   └── RefrigeratorAndTemperatureControlledCabinetMode Cluster
│
└── Freezer Cabinet (0x0071) [tag: Freezer]
    ├── TemperatureControl Cluster (setpoint)
    ├── TemperatureMeasurement Cluster (current temp)
    └── RefrigeratorAndTemperatureControlledCabinetMode Cluster

License

Apache-2.0