homey-cli
by krausefx
Smart Home & IoTBrief
Control Homey home automation hub.
Description
What This Skill Does
A CLI tool for controlling Homey home automation hubs from the terminal or an AI agent. Supports device control (on/off, dimming, colors, temperature), zone listing, flow triggering, and full hub inventory. Uses OAuth for authentication and restricts write operations to a capability allowlist.
The allowlisted capability model lets agents safely control smart home devices without risking destructive operations like deleting devices or modifying flows.
When to Use It
- Turn specific lights on or off by name
- Dim living room lights to a set percentage
- Check current temperature reading from a bedroom sensor
- Trigger a scheduled automation flow
- Get a full inventory of all smart home devices
Example Workflow
User asks: Dim the kitchen lights to 40%
- 1
Run
bash run.sh devices list --jsonto retrieve all devices - 2
Find the device ID matching the kitchen lights
- 3
Run
bash run.sh devices dim <deviceId> 0.4 - 4
Confirm the command output indicates success
Kitchen lights dimmed to 40%
Requirements
- Homey hub on the local network
- Homey developer app credentials (Client ID and Client Secret) from https://tools.developer.homey.app/tools/app
- HOMEY_CLIENT_ID environment variable
- HOMEY_CLIENT_SECRET environment variable
- HOMEY_REDIRECT_URL environment variable
Installation
clawhub install krausefx/homey-cliRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.