Overview
Home Assistant MCP Server is a Model Context Protocol (MCP) server designed for interacting with Home Assistant, allowing users to control and monitor their Home Assistant devices through MCP-enabled applications.
To use the Home Assistant MCP Server, clone the repository, install the dependencies, build the project, and configure the MCP server with your Home Assistant instance URL and access token.
- Get device states - Control device states (on/off) - Trigger automations - List available entities
- Monitoring the state of smart home devices.
- Automating home routines through triggers.
- Integrating with other MCP-enabled applications for enhanced functionality.
Add to your AI client
Use these steps to connect Home Assistant MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"hekmon8-homeassistant-server-mcp-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-hekmon8-homeassistant-server-mcp-mcp-mirror"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"hekmon8-homeassistant-server-mcp-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-hekmon8-homeassistant-server-mcp-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"hekmon8-homeassistant-server-mcp-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-hekmon8-homeassistant-server-mcp-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"hekmon8-homeassistant-server-mcp-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-hekmon8-homeassistant-server-mcp-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hekmon8-homeassistant-server-mcp-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-hekmon8-homeassistant-server-mcp-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"hekmon8-homeassistant-server-mcp-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-hekmon8-homeassistant-server-mcp-mcp-mirror"
]
}
}
}FAQ
Can I control all my Home Assistant devices with this server?
Yes! The server allows you to control any device integrated with your Home Assistant instance.
Is there a cost to use the Home Assistant MCP Server?
No! The Home Assistant MCP Server is open-source and free to use.
How do I secure my Home Assistant MCP Server?
Always use HTTPS, keep your access tokens secure, and regularly rotate them.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":646,"uuid":"6b518811-07a5-4b54-ac28-1a8c7358a300","name":"hekmon8_Homeassistant-server-mcp","title":"Home Assistant MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T03:25:04.366Z","updated_at":"2025-02-23T07:15:13.165Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"home-assistant,mcp-server,automation","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/hekmon8_Homeassistant-server-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]