---
title: "Xiaozhi MCP"
description: "Xiaozhi MCP is a Marketplace integration for Home Assistant. It has 111 installs sharing analytics, needs the vendor's cloud and was last updated October 21, 2026."
canonical: "https://vulpo.app/integrations/marketplace/mac8005-xiaozhi-mcp-ha"
url: "https://vulpo.app/integrations/marketplace/mac8005-xiaozhi-mcp-ha.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Xiaozhi MCP

> Xiaozhi MCP is a Marketplace integration for Home Assistant. It has 111 installs sharing analytics, needs the vendor's cloud and was last updated October 21, 2026.

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](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=mac8005&repository=xiaozhi-mcp-ha&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=mac8005&repository=xiaozhi-mcp-ha&category=integration)

## 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.

## Setting it up

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

### Xiaozhi MCP Configuration

- **Name**: Friendly 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 token**: Create this token in your Home Assistant profile under Security. This is NOT the Xiaozhi token.
- **MCP Server URL**: URL 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 Logging**: Enable detailed logging for debugging

### After setup

- **Scan Interval (seconds)**
- **Enable Debug Logging**

Texts from the code of [mac8005/xiaozhi-mcp-ha](https://github.com/mac8005/xiaozhi-mcp-ha).

## Actions

- **Reconnect**: Reconnect to Xiaozhi MCP endpoint
  Fields: Integration entry
- **Send Message**: Send a message to Xiaozhi
  Fields: 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](https://github.com/mac8005/xiaozhi-mcp-ha#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [AI and voice](https://vulpo.app/integrations/category/ai-and-voice.md), AI models
- Number: 111 installs sharing analytics; 111 GitHub stars
- Connection: Needs the vendor's cloud
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v0.0.27, last updated October 21, 2026
- Domain: `xiaozhi_mcp`
- Source: <https://github.com/mac8005/xiaozhi-mcp-ha>
- Issues: <https://github.com/mac8005/xiaozhi-mcp-ha/issues>
- Screenshot: https://vulpo.app/integrations-img/051468e2b6eb1b68.webp (from mac8005/xiaozhi-mcp-ha's README)

In Vulpo: Quick Toggle card, Chart card, Apple Watch, Control Center

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/mac8005-xiaozhi-mcp-ha

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/mac8005-xiaozhi-mcp-ha
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml