Connects Claude directly to your Home Assistant instance through its REST API. You get tools for reading and updating entity states, calling services, firing events, rendering Jinja templates, and pulling historical data from the logbook. It also exposes resources for browsing your current config, loaded components, and available services. Useful when you want Claude to control your smart home devices, query sensor data, or help debug automations without switching contexts. Requires a long-lived access token and supports Home Assistant 2026.4.1. Install via pip and configure with environment variables pointing to your HA instance.
MCP server exposing Home Assistant 2026.4.1 REST API functionality.
mcp-name: io.github.daedalus/mcp-homeassistant
pip install mcp-homeassistant
Set the following environment variables:
HA_URL: Home Assistant URL (default: http://localhost:8123)HA_TOKEN: Long-Lived Access Token (required)export HA_URL="http://homeassistant:8123"
export HA_TOKEN="your_long_lived_access_token"
mcp-homeassistant
The MCP server exposes the following tools:
get_api_status - Check if the API is runningget_config - Get HA configurationget_components - List loaded componentsget_events - List event types and listener countsget_services - List available services by domainget_states - Get all entity statesget_state - Get a specific entity stateset_state - Update or create an entity statedelete_state - Delete an entity statefire_event - Fire a custom eventcall_service - Call a Home Assistant servicerender_template - Render a Jinja templateget_history - Get historical state changesget_logbook - Get logbook entriescheck_config - Validate configuration.yamlhandle_intent - Handle an intentget_error_log - Get error logget_calendars - List calendar entitiesget_calendar_events - Get calendar eventshomeassistant://config - Current confighomeassistant://states - All entity stateshomeassistant://services - Available serviceshomeassistant://components - Loaded componentsgit clone https://github.com/daedalus/mcp-homeassistant.git
cd mcp-homeassistant
pip install -e ".[test]"
# run tests
pytest
# format
ruff format src/ tests/
# lint
ruff check src/ tests/
# type check
mypy src/