mcp-homeassistant

MCP server exposing Home Assistant 2026.4.1 REST API functionality.

[](https://pypi.org/project/mcp-homeassistant/) [](https://pypi.org/project/mcp-homeassistant/) [](https://github.com/astral-sh/ruff)

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 running
• get_config - Get HA configuration
• get_components - List loaded components
• get_events - List event types and listener counts
• get_services - List available services by domain
• get_states - Get all entity states
• get_state - Get a specific entity state
• set_state - Update or create an entity state
• delete_state - Delete an entity state
• fire_event - Fire a custom event
• call_service - Call a Home Assistant service
• render_template - Render a Jinja template
• get_history - Get historical state changes
• get_logbook - Get logbook entries
• check_config - Validate configuration.yaml
• handle_intent - Handle an intent
• get_error_log - Get error log
• get_calendars - List calendar entities
• get_calendar_events - Get calendar events

• homeassistant://config - Current config
• homeassistant://states - All entity states
• homeassistant://services - Available services
• homeassistant://components - Loaded components