Hass-MCP is a Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing device control, state queries, automation management, and smart home troubleshooting.
Get the Home Assistant version.
Get the state of a specific entity with optional field filtering.
Perform actions on entities (turn on, off, toggle).
Get a list of entities with optional domain filtering and search.
Search for entities matching a query.
Get a summary of a domain's entities.
Get a list of all automations.
Call any Home Assistant service.
Restart Home Assistant.
Get the state history of an entity.
Get the Home Assistant error log.
{
"mcpServers": {
"hass-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HA_URL",
"-e",
"HA_TOKEN",
"voska/hass-mcp"
],
"env": {
"HA_URL": "http://homeassistant.local:8123",
"HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
}
}
}
}