Control Athom Homey smart home devices via local (LAN/VPN) or cloud APIs. List/control devices, trigger flows, query zones. Works with Homey Pro, Cloud, and Bridge.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Control Athom Homey devices via local (LAN/VPN) or cloud APIs using token authentication.
Requires Node.js >= 18.
Decide local vs cloud
Configure
Local (recommended when the agent runs on your home network):
homeycli auth discover-local --save --pick 1 echo "<LOCAL_API_KEY>" | homeycli auth set-local --stdin # or interactive (hidden input): homeycli auth set-local --prompt
Cloud (recommended for VPS/headless hosting):
echo "<CLOUD_TOKEN>" | homeycli auth set-token --stdin # or interactive (hidden input): homeycli auth set-token --prompt
Check status:
homeycli auth status
Test connection
homeycli status
homeycli snapshot --json homeycli snapshot --json --include-flows
homeycli devices # Pretty table output homeycli devices --json # JSON output for AI parsing (includes latest values)Filter by name (returns multiple matches)
homeycli devices --match "kitchen" --json
Turn devices on/off:
homeycli device "Living Room Light" on homeycli device "Bedroom Lamp" off
Set specific capabilities:
homeycli device "Dimmer" set dim 0.5 # 50% brightness homeycli device "Thermostat" set target_temperature 21 # Set temperature homeycli device "RGB Light" set light_hue 0.5 # Hue (0-1) homeycli device "Lock" set locked true # Lock device
Get capability values:
homeycli device "Thermostat" get measure_temperature homeycli device "Motion Sensor" get alarm_motionGet all values for a device (multi-sensors)
homeycli device "Living Room Air" values homeycli device "Living Room Air" get
homeycli flows # List all flows homeycli flows --json # JSON output homeycli flows --match "good" --json # Filter flows by name homeycli flow trigger "Good Night" # Trigger by name homeycli flow trigger <flow-id> # Trigger by ID
homeycli zones # List all zones/rooms homeycli zones --json # JSON output
homeycli status # Show Homey connection info
| Capability | Type | Description | Example |
|---|---|---|---|
| boolean | Power on/off | |
| number | Brightness (0-1) | |
| number | Color hue (0-1) | |
| number | Color saturation (0-1) | |
| number | Color temp (0-1) | |
| number | Thermostat target (°C) | |
| number | Current temp (read-only) | - |
| boolean | Lock state | |
| boolean | Motion detected (read-only) | - |
| boolean | Contact sensor (read-only) | - |
| number | Volume (0-1) | |
Use
homeycli devicesDevice and flow names support fuzzy matching:
Add
--jsonhomeycli devices --json | jq '.[] | select(.class == "light")' homeycli status --json
Morning routine:
homeycli device "Bedroom Light" on homeycli device "Bedroom Light" set dim 0.3 homeycli device "Thermostat" set target_temperature 20
Check temperature:
homeycli device "Living Room" get measure_temperature
Trigger scene:
homeycli flow trigger "Movie Time"
List all lights:
homeycli devices --json | jq '.[] | select(.class == "light") | .name'
"No auth configured"
Local (LAN/VPN):
echo "<LOCAL_API_KEY>" | homeycli auth set-local --address http://<homey-ip> --stdinCloud (remote/headless):
echo "<CLOUD_TOKEN>" | homeycli auth set-token --stdin"Device not found" / ambiguous match
homeycli devices --jsonhomeycli devices --match <query> --jsonid"Capability not supported"
homeycli devicesgetsetThe CLI uses the official
homey-apiAuth/connection modes:
HomeyAPI.createLocalAPI({ address, token })AthomCloudAPINo 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.