homebridge/HAP-NodeJS

Node.js implementation of the HomeKit Accessory Protocol (HAP)

TypeScript

2,722

1,097 commits

updated Aug 22, 2026

See the code

README

HAP-NodeJS


Coverage Status

HAP-NodeJS is an implementation of the HomeKit Accessory Server as specified in the HomeKit Accessory Protocol (HAP), which is defined by Apple as part of the HomeKit Framework.

HAP-NodeJS is intended to be used as a library to easily create your own HomeKit Accessory on a Raspberry Pi, Intel Edison, or any other platform that can run Node.js :)
If you are searching for a pluggable HomeKit bridge with over a thousand community driven plugins to bring HomeKit support to devices which do not support HomeKit out of the box, you may want to look at the homebridge project (which also uses HAP-NodeJS internally).

The implementation tries to follow the HAP specification as close as it can, but may differ in some cases. HAP-NodeJS is not an Apple certified HAP implementation, as this is only available to members of the MFi program.

Getting started

You may start by having a look at our Wiki, especially have a look at the Important HomeKit Terminology used in this project.

There is also a pretty detailed guide on how to start developing with HAP-NodeJS. Or you may just have a look at our examples repository (or some of the old accessory examples).

The documentation (WIP) can be found here.

See the FAQ on how to enable debug output for HAP-NodeJS.

Projects based on HAP-NodeJS

  • Homebridge - HomeKit support for the impatient - Pluggable HomeKit Bridge.
    Plugins available for e.g. Pilight, Telldus TDtool, Savant, Netatmo, Open Pixel Control, HomeWizard, Fritz!Box, LG WebOS TV, Home Assistant, HomeMatic and many more.
  • OpenHAB-HomeKit-Bridge - OpenHAB HomeKit Bridge bridges openHAB items to Apples HomeKit Accessory Protocol.
  • homekit2mqtt - HomeKit to MQTT bridge.
  • pimatic-hap - Pimatic homekit bridge.
  • node-red-contrib-homekit - Node-RED nodes to simulate Apple HomeKit devices.
  • ioBroker.homekit - connect ioBroker to HomeKit.
  • AccessoryServer - HomeKit integration for IR/RF/IP-devices

Notes

Special thanks to Alex Skalozub, who reverse-engineered the server side HAP. You can find his research here. (Sadly, on Nov 4 2014, Apple sent the DMCA request to GitHub to remove the research.)

There is a video demo running this project on Intel Edison.

If you are interested in HAP over BTLE, you might want to check this.

hap
hap-nodejs
hap-server
homekit
homekit-accessory
homekit-accessory-protocol
homekit-device
homekit-protocol
homekit-server
homekit-support
siri

homebridge/HAP-NodeJS

Node.js implementation of the HomeKit Accessory Protocol (HAP)

TypeScript

2,722

1,097 commits

updated Aug 22, 2026

See the code

README

HAP-NodeJS


Coverage Status

HAP-NodeJS is an implementation of the HomeKit Accessory Server as specified in the HomeKit Accessory Protocol (HAP), which is defined by Apple as part of the HomeKit Framework.

HAP-NodeJS is intended to be used as a library to easily create your own HomeKit Accessory on a Raspberry Pi, Intel Edison, or any other platform that can run Node.js :)
If you are searching for a pluggable HomeKit bridge with over a thousand community driven plugins to bring HomeKit support to devices which do not support HomeKit out of the box, you may want to look at the homebridge project (which also uses HAP-NodeJS internally).

The implementation tries to follow the HAP specification as close as it can, but may differ in some cases. HAP-NodeJS is not an Apple certified HAP implementation, as this is only available to members of the MFi program.

Getting started

You may start by having a look at our Wiki, especially have a look at the Important HomeKit Terminology used in this project.

There is also a pretty detailed guide on how to start developing with HAP-NodeJS. Or you may just have a look at our examples repository (or some of the old accessory examples).

The documentation (WIP) can be found here.

See the FAQ on how to enable debug output for HAP-NodeJS.

Projects based on HAP-NodeJS

  • Homebridge - HomeKit support for the impatient - Pluggable HomeKit Bridge.
    Plugins available for e.g. Pilight, Telldus TDtool, Savant, Netatmo, Open Pixel Control, HomeWizard, Fritz!Box, LG WebOS TV, Home Assistant, HomeMatic and many more.
  • OpenHAB-HomeKit-Bridge - OpenHAB HomeKit Bridge bridges openHAB items to Apples HomeKit Accessory Protocol.
  • homekit2mqtt - HomeKit to MQTT bridge.
  • pimatic-hap - Pimatic homekit bridge.
  • node-red-contrib-homekit - Node-RED nodes to simulate Apple HomeKit devices.
  • ioBroker.homekit - connect ioBroker to HomeKit.
  • AccessoryServer - HomeKit integration for IR/RF/IP-devices

Notes

Special thanks to Alex Skalozub, who reverse-engineered the server side HAP. You can find his research here. (Sadly, on Nov 4 2014, Apple sent the DMCA request to GitHub to remove the research.)

There is a video demo running this project on Intel Edison.

If you are interested in HAP over BTLE, you might want to check this.

hap
hap-nodejs
hap-server
homekit
homekit-accessory
homekit-accessory-protocol
homekit-device
homekit-protocol
homekit-server
homekit-support
siri

Project health

Overall

6.4/10

Maintained

10/10

Code review

3/10
OpenSSF Scorecard

Latest release

0.14.3 · Mar 29, 2026

Releases this year

4

Significant stargazers

Dave Nicolson

51 followers · starred Jan 2020

Brian Smith

1,075 followers · starred Dec 2015

Héctor Ramos

989 followers · starred Jan 2016

Stephen Edgar

277 followers · starred Dec 2024