git404hub

what is homekit fr?

liiraliu/homekit — explained in plain English

Analysis updated 2026-05-18

69TypeScriptAudience · developerComplexity · 3/5Setup · moderate

tl;dr

Lets AI assistants like Claude control Apple Home devices, lights, locks, thermostats, through a local bridge so your agent can manage your smart home by conversation.

vibe map

mindmap
  root((repo))
    What it does
      Controls Apple Home devices
      AI agents manage smart home
      Bridge to HomeKit framework
    Tech stack
      TypeScript
      Node.js
      npm packages
    Architecture
      AI agent talks to MCP server
      Local socket to macOS app
      Reaches HomeKit devices
    Tools available
      List accessories
      Set accessory state
      Activate scenes
      Run automations
    Requirements
      macOS 13 Ventura or newer
      Node.js 18 or newer
      Apple Home configured
    Use cases
      Turn off lights at bedtime
      Lock doors via AI chat
      Trigger scenes by conversation
    Audience
      Smart home owners
      AI tool builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Tell your AI assistant you are heading to bed and have it turn off lights, dim lamps, adjust the thermostat, and lock the front door.

VIBE 2

Use the command line tool to list and control all your Apple Home accessories from the terminal without opening the Home app.

VIBE 3

Build an AI agent that can activate or create scenes and run automations across your Apple Home setup.

VIBE 4

Expose your Apple Home devices to AI clients like Claude or Cursor through a structured tool server.

what's the stack?

TypeScriptNode.jsnpmMCPApple HomeKit

how it stacks up fr

liiraliu/homekitdiendh/zca-bridgeutibeabasi6/mercek
Stars696969
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/54/53/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires macOS 13 Ventura or newer, a configured Apple Home on the same Mac, and authorization through the Homekit macOS app.

in plain english

Homekit is an open source project that lets AI assistants control Apple Home devices. Instead of tapping buttons in the Home app or asking Siri, you can have an AI agent turn lights on and off, lock doors, read sensor data, and trigger scenes or automations. The project positions itself as the first open bridge between Apple's HomeKit framework and the AI agent layer. The project is built in TypeScript and ships as several npm packages. The command line tool, homekit-cli, gives you a terminal interface to list accessories, set their states, activate scenes, and run automations. There is also homekit-mcp, a server that exposes eight structured tools any compatible AI client can call. A shared core package handles authorization, types, and the bridge logic, and an optional plugin supports a framework called OpenClaw. The architecture has three layers. At the top, an AI agent like Claude or Cursor talks to the homekit-mcp server using a protocol called MCP. That server communicates over a local socket with a macOS app that handles authorization and talks to Apple's HomeKit framework. From there, it reaches your actual devices: lights, locks, thermostats, sensors, cameras, scenes, automations, and multi-home setups. The eight tools an agent can call cover listing accessories, getting and setting accessory state, activating and creating scenes, and listing and running automations. The README includes a demo conversation where someone tells Claude they are heading to bed, and the agent checks what is on, turns off the right lights, dims the bedroom lamp, adjusts the thermostat, and locks the front door. Requirements are macOS 13 Ventura or newer, Node.js 18 or newer, a configured Apple Home on the same Mac, and the Homekit macOS app for initial authorization. Installation is a global npm install followed by an auth step. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
I have the Homekit MCP server running. Can you list all my HomeKit accessories and tell me which lights are currently on?
prompt 2
I'm going to bed. Check what's on around the house, turn off the lights in the living room and kitchen, dim the bedroom lamp to 20%, set the thermostat to 68, and lock the front door.
prompt 3
Use the homekit-mcp tools to activate my 'Movie Night' scene and then list all automations I have configured.
prompt 4
I just installed homekit-cli globally. Walk me through the authorization step and show me how to list and control accessories from the terminal.

Frequently asked questions

what is homekit fr?

Lets AI assistants like Claude control Apple Home devices, lights, locks, thermostats, through a local bridge so your agent can manage your smart home by conversation.

What language is homekit written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, npm.

How hard is homekit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is homekit for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.