Home Assistant MCP Server

call_ha_service

This is the primary way to control devices in Home Assistant. COMMON SERVICE CALLS: - light.turn_on: entity_id, brightness (0-255), color_temp, rgb_color - light.turn_off: entity_id - switch.turn_on: entity_id - switch.turn_off: entity_id - climate.set_temperature: entity_id, temperature - climate.set_hvac_mode: entity_id, hvac_mode (heat, cool, auto, off) - cover.open_cover: entity_id - cover.close_cover: entity_id - media_player.turn_on: entity_id - media_player.turn_off: entity_id - media_player.media_play: entity_id - automation.trigger: entity_id - script.turn_on: entity_id DOMAINS: light, switch, climate, cover, fan, lock, media_player, automation, script, scene, input_boolean, input_number, notify PARAMETERS: - domain (REQUIRED): Domain name (e.g. light, switch, climate) - service (REQUIRED): Service name (e.g. turn_on, turn_off, set_temperature) - service_data (OPTIONAL): JSON object with service parameters including entity_id EXAMPLES: - "Turn on living room light" → domain="light", service="turn_on", service_data={"entity_id":"light.living_room"} - "Set bedroom temperature to 20" → domain="climate", service="set_temperature", service_data={"entity_id":"climate.bedroom","temperature":20} Call a Home Assistant service on a domain

check_ha_configuration

Check Home Assistant configuration validity

fire_ha_event

The event type must match automation triggers configured in Home Assistant. Fire a custom event in Home Assistant

get_api_status

Use this as a connectivity test before making other API calls. Check if the Home Assistant API is running

get_calendar_events

Get events from a Home Assistant calendar

get_entity_history

Useful for analyzing trends and past behavior. Get historical state data for an entity

get_entity_state

Use entity IDs from list_entity_states (e.g., light.living_room, climate.bedroom, sensor.temperature). Get the current state of a specific entity

get_ha_config

Get the Home Assistant configuration details

get_logbook_entries

Can be filtered by entity and time range. Get Home Assistant logbook entries

list_available_services

g., light: turn_on, turn_off, toggle; climate: set_temperature, set_hvac_mode). Essential for discovering what actions can be performed. List all available services across all domains

list_entity_states

Each entity includes entity_id, state, last_changed timestamp, and attributes. Essential for discovering available devices. List all entity states in Home Assistant

list_ha_calendars

List all calendars configured in Home Assistant

list_ha_components

List all loaded components/integrations in Home Assistant

list_ha_events

Useful for understanding what events Home Assistant is tracking. List all event types currently registered in Home Assistant

render_ha_template

Useful for accessing HA template functions and state from the API. Render a Jinja2 template in Home Assistant