Skip to content
TakoAPI
Back to skills

homey-cli

by krausefx

Smart Home & IoT
1.8kDownloads reported by clawskills.sh
3Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: Dim the kitchen lights to 40%

AGENT
  1. 1

    Run bash run.sh devices list --json to retrieve all devices

  2. 2

    Find the device ID matching the kitchen lights

  3. 3

    Run bash run.sh devices dim <deviceId> 0.4

  4. 4

    Confirm the command output indicates success

OUTPUT

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-cli

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links