ha-xiaozhi-mcp

What is ha-xiaozhi-mcp?

ha-xiaozhi-mcp is a temporary relay solution for connecting Home Assistant to the Xiaozhi MCP server. It runs as a Python MCP server on any environment with Python, acting as a bridge so that Xiaozhi can control smart home devices through Home Assistant.

How to use ha-xiaozhi-mcp?

Download all files, install dependencies with pip install -r requirements.txt, then configure three settings in the config file: your Home Assistant long-lived access token (api_key), your Home Assistant base URL (base_url), and the Xiaozhi MCP endpoint (MCP_ENDPOINT). Start the MCP server by running python mcp_pipe.py hass.py. After startup, check that the MCP configuration shows three available tools. Finally, add device information into Xiaozhi’s prompt using the provided template.

Key features of ha-xiaozhi-mcp

• Temporary relay between Home Assistant and Xiaozhi MCP
• Exposes three tools for device control
• Supports any Home Assistant device entity
• Operates locally or on a local network
• Lightweight Python implementation

Use cases of ha-xiaozhi-mcp

• Allow Xiaozhi to control smart lights, switches, and other devices via Home Assistant
• Bridge Home Assistant to a third‑party MCP service quickly without permanent infrastructure
• Experiment with MCP‑based smart home automation
• Control devices in specific rooms (e.g.,书房) using voice or prompts

FAQ from ha-xiaozhi-mcp

What does ha-xiaozhi-mcp do?

It acts as a temporary relay that connects Home Assistant to the Xiaozhi MCP service, enabling Xiaozhi to send device control commands to Home Assistant.

How do I install and set it up?

Download the repository, run pip install -r requirements.txt, edit the configuration file with your Home Assistant token, base URL, and Xiaozhi MCP endpoint, then execute python mcp_pipe.py hass.py.

Does it support all Home Assistant devices?

It supports any device entity that appears in the Home Assistant entity registry, especially lights and switches. You can control devices by specifying their entity IDs and room locations.

Is ha-xiaozhi-mcp free to use?

The code appears to be open source and free. It requires a valid Home Assistant long‑lived access token and a Xiaozhi MCP endpoint provided by the Xiaozhi platform.

Are there any known limitations?

This is a temporary relay solution, not intended for production use. It runs as a single Python process and may require manual reconfiguration if the MCP endpoint changes. Device entity updates must be manually added to the prompt.