SMART HOME / HM-SH-017

HM-SH-017 · datasheet

xiaozhi-mcp-ha

HACS integration connecting the Xiaozhi ESP32 AI chatbot to Home Assistant via MCP

Part no.	HM-SH-017
Type	integration
Hardware	Home Assistant, ESP32
Language	Python
Transport	stdio
Stars	110
Last push	2025-09-10
Maintainer	mac8005
Source	github.com/mac8005/xiaozhi-mcp-ha

Requirements

Home Assistant 2024.1.0 or later
HACS (Home Assistant Community Store)
Home Assistant MCP Server Integration (must be installed first)
Xiaozhi ESP32 device or compatible hardware
Active internet connection for MCP communication

01 · What it does

Connect Xiaozhi ESP32 devices to Home Assistant
Full MCP (Model Context Protocol) support for AI-powered home automation
Control Home Assistant entities through natural language
Secure authentication with long-lived access tokens
Automatic reconnection with exponential backoff

02 · Install

Requires the Home Assistant MCP Server integration and HACS
Install via HACS, then configure with your Xiaozhi MCP endpoint: see README

Commands copied from the project README. Placeholders are the maintainer's. Not bench-tested by HardwareMCP yet.