About Hass
Hass is an MCP server in the Developer Tools category: mCP implementation of the Home Assistant API.
The repository has 4 stars and 0 forks.
Install
claude mcp add hass -- npx -y hass-mcpnpx -y hass-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (13)
ha_area_lights_offTurn off all lights in an area (by area_id).
Parameters not published.
ha_area_lights_onTurn on all lights in an area (by area_id).
Parameters not published.
ha_call_serviceCall a Home Assistant service (domain/service) with data payload.
Parameters not published.
ha_get_historyFetch history since an ISO time (optionally for an entity).
Parameters not published.
ha_get_logbookFetch logbook entries since an ISO time (optionally for an entity).
Parameters not published.
ha_get_stateGet Home Assistant entity state by entity_id.
Parameters not published.
ha_light_turn_offTurn off a light by entity_id.
Parameters not published.
ha_light_turn_onTurn on a light by entity_id.
Parameters not published.
ha_list_areasList Home Assistant areas from the area registry.
Parameters not published.
ha_list_devicesList Home Assistant devices from the device registry.
Parameters not published.
Show all 13 tools
ha_list_entity_registryList Home Assistant entity registry entries.
Parameters not published.
ha_list_servicesList Home Assistant services and their fields.
Parameters not published.
ha_list_statesList Home Assistant entity states (can be large).
Parameters not published.
Ask AI
Ask AI about Hass
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
hass-mcp
An open-source MCP server for controlling and querying Home Assistant.
- Transport: stdio
- Auth: Home Assistant long-lived token
- API: Home Assistant REST API
Features
Tools exposed:
ha_get_state— get state for an entityha_list_states— list all states (can be large)ha_call_service— call any service
Install
pnpm install
pnpm build
Run
export HASS_URL="http://homeassistant.local:8123"
export HASS_TOKEN="<your long-lived access token>"
pnpm start
Configure in an MCP client
Example (conceptual):
{
"mcpServers": {
"homeassistant": {
"command": "npx",
"args": ["-y", "hass-mcp"],
"env": {
"HASS_URL": "http://homeassistant.local:8123",
"HASS_TOKEN": "..."
}
}
}
}
Security
- Treat tokens as secrets.
- Prefer running this server on the same LAN as Home Assistant.
- If your HA is behind Cloudflare Access, run this MCP server on the LAN side.
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.