homeyControl 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.
Install via ClawdBot CLI:
clawdbot install maxsumrall/homeyInstall Homey CLI:
Install Homey CLIRequires:
Control Athom Homey devices via local (LAN/VPN) or cloud APIs using token authentication.
Requires Node.js >= 18.
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 --promptCloud (recommended for VPS/headless hosting):
echo "<CLOUD_TOKEN>" | homeycli auth set-token --stdin
# or interactive (hidden input): homeycli auth set-token --promptCheck status:
homeycli auth status
homeycli statushomeycli snapshot --json
homeycli snapshot --json --include-flowshomeycli 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" --jsonTurn devices on/off:
homeycli device "Living Room Light" on
homeycli device "Bedroom Lamp" offSet 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 deviceGet capability values:
homeycli device "Thermostat" get measure_temperature
homeycli device "Motion Sensor" get alarm_motion
# Get all values for a device (multi-sensors)
homeycli device "Living Room Air" values
homeycli device "Living Room Air" gethomeycli 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 IDhomeycli zones # List all zones/rooms
homeycli zones --json # JSON outputhomeycli status # Show Homey connection info| Capability | Type | Description | Example |
|------------|------|-------------|---------|
| onoff | boolean | Power on/off | true, false |
| dim | number | Brightness (0-1) | 0.5 (50%) |
| light_hue | number | Color hue (0-1) | 0.33 (green) |
| light_saturation | number | Color saturation (0-1) | 1.0 (full) |
| light_temperature | number | Color temp (0-1) | 0.5 (neutral) |
| target_temperature | number | Thermostat target (Ā°C) | 21 |
| measure_temperature | number | Current temp (read-only) | - |
| locked | boolean | Lock state | true, false |
| alarm_motion | boolean | Motion detected (read-only) | - |
| alarm_contact | boolean | Contact sensor (read-only) | - |
| volume_set | number | Volume (0-1) | 0.5 |
Use homeycli devices to see what capabilities each device supports.
Device and flow names support fuzzy matching:
Add --json to any command for machine-readable output:
homeycli devices --json | jq '.[] | select(.class == "light")'
homeycli status --jsonMorning routine:
homeycli device "Bedroom Light" on
homeycli device "Bedroom Light" set dim 0.3
homeycli device "Thermostat" set target_temperature 20Check temperature:
homeycli device "Living Room" get measure_temperatureTrigger scene:
homeycli flow trigger "Movie Time"List all lights:
homeycli devices --json | jq '.[] | select(.class == "light") | .name'"No auth configured"
Local (LAN/VPN):
echo "" | homeycli auth set-local --address http:// --stdin Cloud (remote/headless):
echo "" | homeycli auth set-token --stdin "Device not found" / ambiguous match
homeycli devices --json (or homeycli devices --match --json ) to find the right id"Capability not supported"
homeycli devices shows what each device supportsget instead of set)The CLI uses the official homey-api npm package (v3.15.0).
Auth/connection modes:
HomeyAPI.createLocalAPI({ address, token }) using the Homey Web App local API key.AthomCloudAPI using a cloud bearer token (PAT) to create a session and access devices/flows/zones.Generated Mar 1, 2026
Property managers can use this skill to automate lighting, climate control, and security systems across multiple rental units. It enables remote monitoring of device statuses and triggers energy-saving flows, reducing operational costs and enhancing tenant comfort through scheduled routines.
Facility managers can integrate this skill to track and control HVAC, lighting, and appliance usage in office spaces or retail stores. By analyzing device data and setting automation flows, they optimize energy consumption, lower utility bills, and ensure compliance with sustainability standards.
Caregivers can deploy this skill to automate home environments for elderly or disabled individuals, controlling lights, locks, and thermostats via voice or scheduled triggers. It enhances safety by monitoring motion sensors and contact alarms, providing alerts and enabling remote assistance without complex setups.
Event planners and hotel staff can use this skill to manage smart devices in conference rooms or guest suites, triggering scenes like 'Presentation Mode' or 'Check-in Routine'. It simplifies control of audio-visual equipment, lighting, and climate, improving guest experiences and operational efficiency during events.
Retail store owners can automate lighting, signage, and security systems to enhance customer engagement and reduce manual tasks. By setting flows based on business hours or occupancy sensors, they save energy, deter theft, and create dynamic shopping environments with minimal technical expertise.
Offer monthly plans for remote monitoring, automation setup, and troubleshooting of Homey devices for residential or commercial clients. Revenue comes from recurring fees, with tiers based on the number of devices or advanced features like energy reports and custom flow design.
Provide on-site or remote setup services for Homey systems, including device integration, automation flow creation, and user training. Charge a flat fee or hourly rate for initial installation, with optional add-ons for ongoing support or upgrades to new devices.
Develop and license custom automation packages using this skill for IoT integrators or smart home companies. Revenue is generated through licensing fees or revenue-sharing agreements, enabling partners to resell pre-configured solutions tailored to specific industries like hospitality or healthcare.
š¬ Integration Tip
Start with local LAN setup for reliability, use JSON output for easy data parsing in AI agents, and leverage fuzzy matching to handle device name variations without exact strings.
Control Sonos speakers (discover/status/play/volume/group).
Control Philips Hue lights/scenes via the OpenHue CLI.
Control Eight Sleep pods (status, temperature, alarms, schedules).
BluOS CLI (blu) for discovery, playback, grouping, and volume.
Control Home Assistant smart home devices, run automations, and receive webhook events. Use when controlling lights, switches, climate, scenes, scripts, or any HA entity. Supports bidirectional communication via REST API (outbound) and webhooks (inbound triggers from HA automations).
Use when integrating with Tesla's official Fleet API to read vehicle/energy device data or issue remote commands (e.g. start HVAC preconditioning, wake vehicle, charge controls). Covers onboarding (developer app registration, regions/base URLs), OAuth token flows (third-party + partner tokens, refresh rotation), required domain/public-key hosting, and using Tesla's official vehicle-command/tesla-http-proxy for signed vehicle commands.