Control smart home devices via Homebridge Config UI X REST API. Use to list, turn on/off, adjust brightness, color, or temperature of HomeKit-compatible accessories. Supports lights, switches, thermos
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Control smart home devices through Homebridge Config UI X's REST API.
~/.clawdbot/credentials/homebridge.json{ "url": "https://homebridge.local:8581", "username": "admin", "password": "your-password" }
Homebridge Config UI X exposes a REST API. View full documentation at
{HOMEBRIDGE_URL}/swaggerAll API calls require a Bearer token. Obtain it first:
# Get auth token TOKEN=$(curl -s -X POST "${HOMEBRIDGE_URL}/api/auth/login" \ -H "Content-Type: application/json" \ -d "{\"username\":\"${HOMEBRIDGE_USERNAME}\",\"password\":\"${HOMEBRIDGE_PASSWORD}\"}" \ | jq -r '.access_token')
curl -s "${HOMEBRIDGE_URL}/api/accessories" \ -H "Authorization: Bearer ${TOKEN}" | jq
Response includes accessory
uniqueIdserviceNametypevaluescurl -s "${HOMEBRIDGE_URL}/api/accessories/layout" \ -H "Authorization: Bearer ${TOKEN}" | jq
Use PUT to update accessory characteristics:
# Turn on a light/switch curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}" \ -H "Authorization: Bearer ${TOKEN}" \ -H "Content-Type: application/json" \ -d '{"characteristicType": "On", "value": true}'Turn off
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}"
-H "Authorization: Bearer ${TOKEN}"
-H "Content-Type: application/json"
-d '{"characteristicType": "On", "value": false}'Set brightness (0-100)
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}"
-H "Authorization: Bearer ${TOKEN}"
-H "Content-Type: application/json"
-d '{"characteristicType": "Brightness", "value": 50}'Set color (Hue: 0-360, Saturation: 0-100)
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}"
-H "Authorization: Bearer ${TOKEN}"
-H "Content-Type: application/json"
-d '{"characteristicType": "Hue", "value": 240}'Set thermostat target temperature
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}"
-H "Authorization: Bearer ${TOKEN}"
-H "Content-Type: application/json"
-d '{"characteristicType": "TargetTemperature", "value": 22}'
| Type | Values | Description |
|---|---|---|
| | Power state |
| | Light brightness % |
| | Color hue in degrees |
| | Color saturation % |
| | Color temp in Mired |
| | Thermostat target °C |
| | 0=Off, 1=Heat, 2=Cool, 3=Auto |
| | Fan speed % |
| | Active state (fans, etc.) |
For convenience, use the provided scripts:
scripts/homebridge_api.py list scripts/homebridge_api.py list --room "Living Room" scripts/homebridge_api.py list --type Lightbulb
# Turn on/off scripts/homebridge_api.py set <uniqueId> On true scripts/homebridge_api.py set <uniqueId> On falseAdjust brightness
scripts/homebridge_api.py set <uniqueId> Brightness 75
Set color
scripts/homebridge_api.py set <uniqueId> Hue 120 scripts/homebridge_api.py set <uniqueId> Saturation 100
scripts/homebridge_api.py get <uniqueId>
uniqueId/swaggerOnonNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.