Overview
What is Ha Mcp For Xiaozhi?
Ha Mcp For Xiaozhi is an MCP server for Home Assistant that connects directly to the official Xiaozhi AI server via WebSocket, enabling Xiaozhi to control Home Assistant entities and proxy additional MCP services. It is designed for Home Assistant users who want to integrate their smart home with the Xiaozhi AI voice assistant.
How to use Ha Mcp For Xiaozhi?
Install via HACS (search “xiaozhi” or “ha-mcp-for-xiaozhi”), then restart Home Assistant. Configure by adding the integration from Settings > Devices & Services > “MCP Server for Xiaozhi”, enter the Xiaozhi MCP access point address, select desired MCP groups, and submit. Wait about one minute, then refresh the Xiaozhi access point page to verify the connection.
Key features of Ha Mcp For Xiaozhi
- Home Assistant acts as its own MCP server without a proxy.
- Select multiple API groups in one entity (built-in HA API + user MCP servers).
- Proxy all selected groups together to Xiaozhi AI.
- Supports configuring multiple entities simultaneously.
Use cases of Ha Mcp For Xiaozhi
- Control Home Assistant entities (lights, switches, etc.) via Xiaozhi AI voice commands.
- Proxy custom MCP services (e.g., TV control via script) to Xiaozhi for unified control.
- Combine Home Assistant, LLM, MCP, and Xiaozhi for advanced automation scenarios.
- Manage multiple Xiaozhi access points or devices with different configurations.
FAQ from Ha Mcp For Xiaozhi
What tools are exposed to Xiaozhi?
The exposed tools depend on which entities you have made public in Home Assistant’s Voice Assistant settings (Settings > Voice Assistants > Expose).
What if Xiaozhi does not execute a command correctly?
Check the Xiaozhi chat log to see how it processed the command and whether it called any Home Assistant tools. Known conflicts exist with built-in light and music controls; this will be resolved after the Xiaozhi server supports built-in tool selection next month.
How do I debug the plugin?
Enable the plugin’s debug logs and observe the actual execution after confirming the correct HA built‑in function is called.
What Home Assistant version is recommended?
Always use the latest version of Home Assistant; newer releases provide more tools and better compatibility.
How is authentication handled?
The server connects directly to the Xiaozhi official server via WebSocket. No additional authentication configuration is described beyond filling in the Xiaozhi MCP access point address.
