Home Assistant MCP Server
@hekmon8
About Home Assistant MCP Server
A Model Context Protocol (MCP) server for interacting with Home Assistant. This server provides tools to control and monitor your Home Assistant devices through MCP-enabled applications.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"Homeassistant-server-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@hekmon8/Homeassistant-server-mcp",
"--client",
"claude"
]
}
}
}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 is a Model Context Protocol (MCP) server for interacting with Home Assistant. It provides tools to control and monitor Home Assistant devices through MCP-enabled applications, such as Claude Desktop. It is designed for Home Assistant users who want to integrate AI assistants with their smart home setup.
How to use Home Assistant MCP Server?
Install automatically via Smithery (npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude) or manually by cloning the repo, running npm install and npm run build, then configuring the MCP settings file with your Home Assistant URL (HA_URL) and a long-lived access token (HA_TOKEN). The server exposes four tools: get_state, toggle_entity, trigger_automation, and list_entities.
Key features of Home Assistant MCP Server
- Get device states from Home Assistant
- Control device states (turn on/off)
- Trigger automations by automation ID
- List available entities, optionally filtered by domain
Use cases of Home Assistant MCP Server
- Ask an AI assistant to turn lights on/off
- Query the current state of any Home Assistant entity
- Trigger a morning routine automation from a chat interface
- List all lights or switches in the system to discover entities
- Monitor and control smart home devices without opening the Home Assistant UI
FAQ from Home Assistant MCP Server
What are the runtime dependencies?
Node.js and npm are required to build and run the server. A running Home Assistant instance with a long-lived access token is also needed.
How do I securely provide my Home Assistant credentials?
Set the HA_URL and HA_TOKEN environment variables in your MCP settings file. Always use HTTPS for your Home Assistant instance, keep access tokens secret, and never commit them to version control.
Where does my data live?
All device data stays on your local Home Assistant instance. The MCP server only reads from and writes to your instance; no data is sent to external services.
What transport protocol does the server use?
The server uses the standard Model Context Protocol (MCP) for communication with MCP-enabled clients.
How can I contribute or get support?
Fork the repository and submit pull requests. For issues, check existing repository issues or create a new one with context. Additional support resources are available at www.aimcp.info.
More AI & Agents MCP servers
Hass-MCP
voskaControl and query Home Assistant from Claude and other LLMs — a Model Context Protocol (MCP) server.
Model Context Protocol Server for Home Assistant
tevonsbA MCP server for Home Assistant
MCP Client for Ollama (ollmcp)
joniglHarness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre
Shell and Coding agent for Claude and other mcp clients
rusiaamanShell and coding agent on mcp clients
MCP Manager for Claude Desktop
zueaisimple web ui to manage mcp (model context protocol) servers in the claude app
Comments