Home Assistant MCP
About
A free, private, and secure remote MCP server for Home Assistant.
Details
- Author
- miguelg719
- Downloads
- 376
- Categories
- Other, AI
Jump to
- Provides tools for lights, climate, locks, alarm panels, and humidifiers.
- Includes prompts for each supported domain.
- Requires only a Home Assistant long-lived access token and base URL.
- Supports setup with Claude Desktop and other MCP hosts.
- Published as a Python package on PyPI.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Home Assistant MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server by setting HOMEASSISTANT_TOKEN and HOMEASSISTANT_BASE_URL in a .env file. Install via uv or uvx and add the server to your MCP host configuration (e.g., Claude Desktop) under mcpServers as home-assistant-server. Use the provided tools and prompts for each supported domain.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"home assistant mcp": {
"home-assistant-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"home-assistant-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}What can you do with Home Assistant MCP?
- Check device states and sensor readings— Ask your AI to retrieve live states from your Home Assistant entities using the MCP server’s state inspection tools.
- Control smart home devices— Instruct your AI to turn lights on/off, adjust thermostats, lock doors, or trigger scenes via secure control tools with fine-grained permissions.
- Create and edit automations— Have your AI write or modify Home Assistant automations and scripts by inspecting your current setup through the MCP tools.
- Manage dashboards— Let your AI inspect and edit your Home Assistant dashboards directly using the MCP server’s dashboard tools.
- Debug services and integrations— Ask your AI to examine running services, troubleshoot issues, and understand integration configurations using the MCP inspection tools.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
