On the Mac App StoreMIT LicenseFree & Open Source8 MCP ToolsmacOS

HomeKit,
Unboxed

Apple HomeKit has no public API, no CLI, and no way to talk to AI assistants. HomeClaw fixes that with a CLI, MCP server, and plugins for Claude Code and OpenClaw.

Download on the Mac App StoreQuick StartView on GitHub
homeclaw-cli -- zsh -- 120x48
> homeclaw-cli status

HomeClaw  connected
  Home:     Lake House
  Rooms:    12
  Devices:  47 accessories
  Webhook:  healthy (circuit closed, 142 delivered)

> homeclaw-cli list --room "Kitchen"

Kitchen (6 accessories)

   ON  Kitchen Pendant       lightbulb  brightness: 80%
  OFF  Under Cabinet Lights  lightbulb  brightness: 0%
   ON  Kitchen Outlet        outlet     in use
   --  Kitchen Motion        sensor     no motion
   --  Kitchen Temp          sensor     71.2 F
   --  Fridge Contact        sensor     closed

> homeclaw-cli set "Kitchen Pendant" brightness 50

done Kitchen Pendant brightness 80% -> 50%

> homeclaw-cli trigger "Good Night"

done Scene triggered: Good Night
  14 accessories updated

> |

Everything You Need

A complete toolkit for HomeKit: 8 MCP tools, a full CLI, and plugins for Claude Code and OpenClaw.

🏠

HomeKit Access

The only way to control HomeKit from outside the Home app. HomeClaw bridges Apple's private API with a clean, scriptable interface.

🛠️

8 MCP Tools

Accessories, rooms, scenes, device maps, events, webhooks, and config. Everything you need to manage your smart home.

🔌

3 Client Options

Use with Claude Code MCP, the OpenClaw plugin, or the CLI directly. Pick what fits your workflow.

🗺️

LLM Device Map

Purpose-built device map with semantic types, auto-generated aliases, and state summaries. AI assistants understand your home instantly.

📡

Webhooks

Push HomeKit events to OpenClaw with configurable triggers, delivery modes, and a tiered circuit breaker for reliability.

📋

Event Log

Full event history of characteristic changes, scene triggers, and control actions. Query by time, type, or accessory.

Screenshots

Menu bar, CLI, and terminal UI — all driven by the same socket, all local.

Onboarding — welcome screen with HomeKit setup
Onboarding
Settings — HomeKit homes and accessories overview
Settings
Terminal UI — accessory tree with live status
Terminal UI
CLI — list every accessory in one command
CLI list
CLI — toggle and inspect any accessory
CLI toggle

How It Works

Three layers, one Unix socket

🤖
AI Client
Claude Code, OpenClaw, or CLI
↓
⚡
MCP Server / CLI
Unix socket, JSON protocol
↓
🏠
HomeClaw App
Mac Catalyst, direct HomeKit access

Single-process design. Apple's HMHomeManager requires a UIKit/Catalyst app with the HomeKit entitlement. HomeClaw runs as a lightweight menu bar app.

8 Tools, Full Coverage

Consolidated tools with actions, not a tool per operation

Accessories

homekit_accessories

List, get details, search, or control any HomeKit accessory

listgetsearchcontrol

Rooms

homekit_rooms

Browse rooms and their accessories

Scenes

homekit_scenes

List and trigger HomeKit scenes

listtrigger

Device Map

homekit_device_map

LLM-optimized map with semantic types and aliases

Events

homekit_events

Query characteristic changes, scene triggers, control actions

Webhooks

homekit_webhook

Configure, test, and monitor webhook delivery

setuptestresetstatus

Config

homekit_config

Set active home, device filtering, and preferences

getset

Status

homekit_status

Check connectivity, home count, and accessory count

Supported Accessories

LightsThermostatsLocksDoorsGarage DoorsFansWindow CoveringsSwitchesOutletsSensorsDoorbellsCameras

Quick Start

Install the app, then pick your integration method

1
Install HomeClawTestFlight
# Join the TestFlight beta
https://testflight.apple.com/join/zjSnz8eK


# Or build from source
git clone https://github.com/omarshahine/HomeClaw.git
cd HomeClaw && scripts/build.sh --release --install
2
Claude CodePlugin
# Register the marketplace and install
/plugin marketplace add ~/GitHub/HomeClaw
/plugin install homeclaw@homeclaw


# Then just ask Claude:
"Turn off all the lights in the kitchen"
"Set the thermostat to 72"
3
OpenClawPlugin
# Install from the bundled app
openclaw plugins install \
  "/Applications/HomeClaw.app/Contents/Resources/openclaw/"
openclaw plugins enable homeclaw


# Symlink the CLI into PATH (Apple Silicon)
ln -sf "/Applications/HomeClaw.app/Contents/MacOS/homeclaw-cli" \
  /opt/homebrew/bin/homeclaw-cli


# Restart the gateway
openclaw gateway restart
4
CLITerminal
# List devices by room
homeclaw-cli list --room "Living Room"


# Control a device
homeclaw-cli set "Bedroom Light" brightness 40


# Trigger a scene
homeclaw-cli trigger "Good Night"