LaunchKit · 2026
Back to Skills

homey-cli

Control Homey home automation hub.

3
1.8k downloads
by @krausefx

Setup & Installation

openclaw skills install @krausefx/homey-cli

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install homey-cli

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

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Dim the kitchen lights to 40%

AGENT
  1. 1Run `bash run.sh devices list --json` to retrieve all devices
  2. 2Find the device ID matching the kitchen lights
  3. 3Run `bash run.sh devices dim <deviceId> 0.4`
  4. 4Confirm the command output indicates success
OUTPUT

Kitchen lights dimmed to 40%

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Homey hub on the local networkHomey developer app credentials (Client ID and Client Secret) from https://tools.developer.homey.app/tools/appHOMEY_CLIENT_ID environment variableHOMEY_CLIENT_SECRET environment variableHOMEY_REDIRECT_URL environment variable