Xiaozhi MCP Ha, developed by Mac8005, is a Home Assistant Custom Integration (HACS) designed to link the Xiaozhi ESP32 AI chatbot with Home Assistant via the Model Context Protocol (MCP). This free, Python-based tool acts as a bridge, allowing voice control of smart home devices. It empowers makers and Home Assistant users to integrate ESP32 AI devices for enriched smart home interaction, extending the functionality of their current setups.

What does Xiaozhi MCP Ha connect to?

The Xiaozhi MCP Ha integration connects the Xiaozhi ESP32 AI chatbot to Home Assistant. It functions as a Home Assistant Custom Integration, serving as a bridge or proxy. This connection routes interactions between the Xiaozhi ESP32 device and the official Home Assistant MCP Server integration. It ensures that commands from the Xiaozhi cloud service can reach and control local Home Assistant entities, establishing a cohesive smart home ecosystem.

Core features and tools

The Xiaozhi MCP Ha integration itself does not expose specific callable tools directly. Instead, it acts as a conduit, forwarding Model Context Protocol (MCP) requests from the Xiaozhi cloud service to the local Home Assistant MCP Server. The callable tools are the Home Assistant entities, such as lights, scenes, GPIO, relays, LEDs, motors, and sensors. These are configured within the Home Assistant MCP Server settings and made public to the Home Assistant voice assistant. The integration supports WebSocket and HTTP endpoints for communication with the Xiaozhi cloud service and forwards MCP requests to the local Home Assistant MCP Server via Server-Sent Events (SSE). The confirmed compatible AI client is the Xiaozhi ESP32 AI chatbot/device.

Who is it for?

Xiaozhi MCP Ha is for makers and engineers who want to build open and customizable ESP32 AI voice assistants. It also serves Home Assistant users who aim to integrate Xiaozhi ESP32 devices for voice control of their smart homes. The tool helps these groups achieve advanced automation and interaction with their smart home setups using natural language. Skip this if you do not use a Xiaozhi ESP32 AI chatbot or Home Assistant.

How to get started

Access is granted through Home Assistant Long-Lived Access Tokens. Communication with the Xiaozhi cloud service uses WebSocket and HTTP endpoints.

Use cases

• Voice control of smart home devices through natural language commands issued to a Xiaozhi ESP32 device, which are then executed by Home Assistant.
• Natural language interaction with various Home Assistant entities, such as toggling lights or scenes.
• Real-time status monitoring and logging for debugging and operational oversight of the integration.

Xiaozhi MCP Ha provides a critical link for integrating Xiaozhi ESP32 AI chatbots with Home Assistant, enabling voice control of smart home devices. It is a valuable tool for those building custom ESP32 AI voice assistants and Home Assistant users seeking advanced control. The integration relies on existing Home Assistant infrastructure and specific authentication.