🤝
@miguelg719
About 🤝
An MCP server for Home Assistant
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"home-assistant-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Home Assistant MCP Server?
This server implements the Model Context Protocol (MCP) to integrate with Home Assistant, providing smart home control capabilities for AI assistants. It is designed for developers and smart home users who want to control Home Assistant through conversational interfaces.
How to use Home Assistant MCP Server?
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.
Key features of Home Assistant MCP Server
- 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.
Use cases of Home Assistant MCP Server
- Turn lights on/off and adjust brightness via an AI assistant.
- Set temperature and HVAC mode using natural language.
- Lock or unlock doors through a conversational interface.
- Arm or disarm a home security system with voice commands.
- Control humidifier humidity levels remotely.
FAQ from Home Assistant MCP Server
What prerequisites are needed?
A running Home Assistant instance, a long-lived access token from your Home Assistant profile, and the base URL of your Home Assistant (e.g., http://homeassistant.local:8123).
How is authentication handled?
The server uses a long-lived access token set in the HOMEASSISTANT_TOKEN environment variable. The token must be generated from the Home Assistant instance after onboarding.
What transport does the server use?
The MCP server communicates over stdio, which is standard for MCP servers. Debugging can be done using the MCP Inspector.
Does the server support all Home Assistant entities?
No, currently only lights, climate, locks, alarm control panels, and humidifiers are supported. Other domains are not yet implemented.
How can I install the server?
The server can be run via uv for development or via uvx for the published version. Configuration examples for Claude Desktop are provided in the README.
Frequently asked questions
What prerequisites are needed?
A running Home Assistant instance, a long-lived access token from your Home Assistant profile, and the base URL of your Home Assistant (e.g., `http://homeassistant.local:8123`).
How is authentication handled?
The server uses a long-lived access token set in the `HOMEASSISTANT_TOKEN` environment variable. The token must be generated from the Home Assistant instance after onboarding.
What transport does the server use?
The MCP server communicates over stdio, which is standard for MCP servers. Debugging can be done using the MCP Inspector.
Does the server support all Home Assistant entities?
No, currently only lights, climate, locks, alarm control panels, and humidifiers are supported. Other domains are not yet implemented.
How can I install the server?
The server can be run via `uv` for development or via `uvx` for the published version. Configuration examples for Claude Desktop are provided in the README.
Basic information
More AI & Agents MCP servers
Model Context Protocol for Unreal Engine
chongdashuEnable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
Web Agent Protocol
OTA-Tech-AI🌐Web Agent Protocol (WAP) - Record and replay user interactions in the browser with MCP support
Transform MCP
UnstructuredThe Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD
Shell and Coding agent for Claude and other mcp clients
rusiaamanShell and coding agent on mcp clients
Mcp Agent
lastmile-aiBuild effective agents using Model Context Protocol and simple workflow patterns
Comments