The catalogue/Homey
Homey
app.homey
Control devices, run automations, and monitor energy on your Homey smart home hub
Version2.0.0
Categoryother
AuthOAuth 2
Tools13
Transportstdio
LicenceMIT
01
What it does
The app, in its own words.
Homey smart home controller — control devices, manage flows, and monitor your home via Athom Cloud API.
02
Tools
13 tools the agent can call.
Every one is declared with typed parameters and returns structured results, so the host can render them instead of narrating them.
- homey-get-deviceGet detailed information and current state of a specific Homey device by ID.
- homey-get-energyGet live energy report from Homey including current power usage and generation across the home.
- homey-get-system-infoGet Homey system information including firmware version, model, uptime, Wi-Fi status, and more.
- homey-get-userGet authenticated user information from Homey.
- homey-get-variablesList all logic variables configured in Homey. Logic variables are used in flows/automations for state tracking.
- homey-list-appsList all apps installed on Homey. Useful for diagnostics and checking which integrations are active.
- homey-list-devicesList all devices connected to Homey with their zone, class, capabilities, and availability status.
- homey-list-flowsList all flows (automations) configured in Homey.
- homey-list-notificationsList notifications from Homey (alerts, warnings, system messages).
- homey-list-zonesList all zones (rooms/areas) configured in Homey.
- homey-set-capabilitySet a device capability value (e.g., turn on/off, set brightness, temperature). Use homey-list-devices to find device IDs and capabilities.
- homey-set-variableSet the value of a Homey logic variable by its ID. Use homey-get-variables to find variable IDs.
- homey-trigger-flowTrigger (run) a Homey flow by its ID.
03
Auth and permissions
What it asks for.
Declared in the manifest, in advance. The app cannot reach anything it did not ask for here.
Scopes
account.homeyshomey.app.readonlyhomey.device.readonlyhomey.device.controlhomey.energy.readonlyhomey.flow.readonlyhomey.flow.starthomey.insights.readonlyhomey.logichomey.logic.readonlyhomey.notifications.readonlyhomey.presence.readonlyhomey.presence.selfhomey.user.readonlyhomey.user.selfhomey.zone.readonly
System secrets
CLIENT_IDCLIENT_SECRET
User secrets
ACCESS_TOKENREFRESH_TOKENTOKEN_TYPEEXPIRES_IN
Reading further
The manifest and the source for Homey live in the monorepo, alongside the other apps.