---
title: "Home Assistant Integration"
description: "Control exposed TapHome devices in Home Assistant through the TapHome API: install via HACS or manually, then add the Core API token and device IDs."
url: "https://taphome.com/en/docs/expose-devices/home-assistant/"
language: en
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["home-assistant-integration","taphome-api","smart-home-automation","hacs"]
  questions: ["How do I integrate TapHome with Home Assistant?","What TapHome devices can I control through Home Assistant?","How to install TapHome integration via HACS?","How to manually install TapHome Home Assistant integration?","What credentials do I need to configure TapHome in Home Assistant?","Where do I get the TapHome Core API token and device IDs for Home Assistant?"]
---

# Home Assistant Integration

TapHome devices appear in Home Assistant through the TapHome API, using an integration installed via HACS or manually.

Last updated: 2026-11-06

TapHome devices get into Home Assistant through the TapHome API: a TapHome integration, installed via HACS or manually, uses this API to control the devices you expose. You need to expose the devices through the TapHome API and obtain the API token of the TapHome Core and the IDs of the devices. After you add these credentials to the Home Assistant configuration, you can control the exposed lighting, switching devices, shading systems and sensors from Home Assistant.

## Overview

The TapHome integration enables control of exposed devices through Home Assistant, utilizing the TapHome API for communication.

## Supported Device Categories

**Lighting Control**
- Power switching
- Intensity/brightness adjustment
- Color modification capabilities

**Switching Devices**
- Electrical sockets
- Digital output controls

**Shading Systems**
- Position level control
- Slat angle adjustment for blinds

**Additional Devices**
- Garage door operators
- Temperature and humidity sensors
- TapHome variables
- Motion detectors
- Energy consumption monitors
- Light level sensors
- CO2 detectors
- Wind speed meters

## Installation Methods

### HACS Installation

Users can install via HACS using the following method:

![HACS interface screenshot](https://taphome.com/documentation/expose-devices/home-assistant-hacs.webp)

Navigate to "HACS > Integration > Explore & Add Repository > TapHome > Install Repository"

![Installation dialog screenshot](https://taphome.com/documentation/expose-devices/home-assistant-install.webp)

### Manual Setup Alternative

Alternatively, you can manually transfer the `/custom_components/taphome/` directory contents from the repository to the designated folder location.

![Manual installation instructions screenshot](https://taphome.com/documentation/expose-devices/home-assistant-manual.webp)

## Configuration Requirements

To enable integration, users must:

1. Expose devices through TapHome API
2. Obtain the API token of the TapHome Core and the IDs of the devices
3. Add credentials to Home Assistant configuration settings

For detailed configuration instructions, refer to the [project's wiki documentation](https://github.com/martindybal/taphome-homeassistant/wiki/Configuration).

**See also** — [TapHome API](https://taphome.com/en/docs/expose-devices/taphome-api/), [TapHome to Amazon Alexa](https://taphome.com/en/docs/expose-devices/alexa/).