Xiaozhi MCP for Home Assistant (Marketplace integration)

Installs: 111 sharing analytics
GitHub stars: 111
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v0.0.27, October 21, 2026
Category: AI and voice, AI models
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: xiaozhi_mcp
Source: github.com/mac8005/xiaozhi-mcp-ha
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of mac8005/xiaozhi-mcp-ha.

About

Xiaozhi MCP connects a Xiaozhi ESP32 AI chatbot to Home Assistant through the Model Context Protocol. It lets the chatbot control Home Assistant entities by natural language, using the Home Assistant MCP Server integration and a long-lived access token. The integration adds sensors and switches, plus actions to reconnect to the Xiaozhi endpoint and to send a message to Xiaozhi. It reconnects automatically with exponential backoff and checks connection status at a configurable interval, with an optional debug logging setting. It depends on the vendor's cloud, and it is set up in the UI with the Xiaozhi endpoint URL.

Automatic summary of the README and code of mac8005/xiaozhi-mcp-ha. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Xiaozhi MCP Configuration

NameFriendly name for this integration instance
Complete Xiaozhi endpoint URL (including token)Paste the complete URL copied from Xiaozhi, including ?token=...; do not move its token to the field below.
Home Assistant long-lived access tokenCreate this token in your Home Assistant profile under Security. This is NOT the Xiaozhi token.
MCP Server URLURL of your Home Assistant MCP Server (default: http://localhost:8123/mcp_server/sse)
Scan Interval (seconds)How often to check connection status (default: 30 seconds)
Enable Debug LoggingEnable detailed logging for debugging

After setup

Scan Interval (seconds)
Enable Debug Logging

Texts from the code of mac8005/xiaozhi-mcp-ha.

Actions

ReconnectReconnect to Xiaozhi MCP endpointFields: Integration entry
Send MessageSend a message to XiaozhiFields: Message, Integration entry

From the README

A Home Assistant Custom Integration (HACS) that connects Xiaozhi ESP32 AI chatbot to Home Assistant via MCP (Model Context Protocol).
🤖 Connect Xiaozhi ESP32 devices to Home Assistant
🔌 Legacy HTTP/SSE 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
📊 Real-time status monitoring and logging
🛠️ Easy configuration through Home Assistant UI
🌐 TLS-verified WebSocket and HTTP/SSE endpoints

From the README of mac8005/xiaozhi-mcp-ha, MIT License. Shortened.