Content
# ha_mcp_xiaozhi_bridge
XiaoZhi AI connects to HA via MCP Agent
Official XiaoZhi server (Xia Ge) integration with Home Assistant's MCP server bridge.
### Principle
Using the sample code provided by XiaoZhi, combined with mcp_proxy, to establish a connection between the official XiaoZhi server and Home Assistant's MCP server, and integrate it into HA as a plugin.
### Installation
Please install using the following methods:
#### Method 1: Install via HACS
> 1. Ensure that `Home Assistant` has HACS installed.
> 2. Open `HACS`, click on `[Custom repositories]`, enter `Repository`: `https://github.com/linrol/ha_mcp_xiaozhi_bridge`, and select `[Integration]` for `Category`.
> 3. Search for `MCP XiaoZhi Bridge` and download it.
> 4. **Restart Home Assistant**.
#### Method 2: Manual Installation
> 1. Download `mcp_bridge.zip` from the [Latest Release](https://github.com/linrol/ha_mcp_xiaozhi_bridge/releases/latest).
> 2. Unzip and copy `mcp_bridge` to `/custom_components/`.
> 3. **Restart Home Assistant**.
### Configuration
[Settings > Devices & Services > Add Integration] > Search for “`MCP XiaoZhi Bridge`” > Next > Please enter the required configuration parameters. The parameter descriptions and how to obtain them are as follows:
- **XIAOZHI_MCP_ENDPOINT**: Your XiaoZhi MCP endpoint.
- **HA_MCP_ENDPOINT**: Your HA MCP SERVER address.
- **API_ACCESS_TOKEN**: Your long-lived API token.
1. **XiaoZhi MCP Endpoint:** You can obtain this by logging into the official XiaoZhi server.
2. **HA MCP SERVER Address:** Obtain this through the official HA `mcp_server` integration.
* Click this link: [Home Assistant MCP Server Integration](https://my.home-assistant.io/redirect/config_flow_start?domain=mcp_server) for direct installation.
* Or in Home Assistant, go to **Settings > Devices & Services > Add Integration**.
* Select “**Model Context Protocol Server**” from the list and follow the on-screen instructions to complete the setup.
3. **Long-lived API Token:** Used for authorizing access to your Home Assistant instance.
* Visit your [Home Assistant account profile settings](https://my.home-assistant.io/redirect/profile), and go to the “**Security**” tab.
* Create a **Long-lived Access Token**.
### Start
After configuration, a switch entity will appear to control the integration's activation and deactivation. Once successfully activated, you can see the endpoint status in the XiaoZhi console MCP endpoint.
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
Time
A Model Context Protocol server for time and timezone conversions.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
earl
Secure CLI proxy for AI agents — HCL-defined operation templates with OS...
sap-ai-mcp-servers
SAP MCP Servers and SAP AI Skills (Open Source, GitHub)
linggen-memory
A local-first memory layer for AI (Cursor, Zed, Claude). Persistent...