| name | itsyhome-control |
| description | Control and query HomeKit and Home Assistant smart home devices via the Itsyhome macOS app (https://itsyhome.app). Use when the user asks to turn devices on/off, toggle lights, set brightness/temperature/color/fan speed/blind position, lock/unlock doors, open/close garage doors, run scenes, list rooms or devices, check device state or status. Requires Itsyhome Pro running on the same Mac as the OpenClaw gateway. Trigger on any smart home control intent (lights, thermostat, locks, blinds, fans, cameras, scenes, groups). |
Itsyhome Control
Itsyhome exposes a local HTTP webhook server (default port 8423) and a URL scheme (itsyhome://).
Prerequisites: Itsyhome Pro, webhook server enabled in Settings → Webhooks.
Core Pattern
All control and query happens via curl http://localhost:8423/<action>/<target>.
- Targets use
Room/Device format or just DeviceName
- Spaces →
%20 in URLs
- On success:
{"success": true} or JSON data
- On failure:
{"error": "..."} with HTTP 4xx
Workflow
- If target is ambiguous →
curl http://localhost:8423/list/devices to find exact names
- To check current state →
curl http://localhost:8423/info/<target>
- To control → appropriate action endpoint (see references/api.md)
- Confirm to user with what was done; include state if queried
Quick Reference
curl http://localhost:8423/status
curl http://localhost:8423/list/rooms
curl http://localhost:8423/list/devices
curl http://localhost:8423/list/devices/Kitchen
curl http://localhost:8423/info/Office/Spotlights
curl http://localhost:8423/toggle/Office/Spotlights
curl http://localhost:8423/on/Kitchen/Light
curl http://localhost:8423/brightness/50/Bedroom/Lamp
curl http://localhost:8423/scene/Goodnight
For the full endpoint list, all control actions, and URL scheme reference: see references/api.md.
