Home Assistant MCP Server

Read from the package source without running it. The installed server may list more.

• ha_addon_info

  Get detailed information about a specific add-on

• ha_addon_options

  Get or set configuration options for an add-on

• ha_call_service

  Call a Home Assistant service (e.g. turn on a light, lock a door, send a notification)

• ha_check_api

  Check if the Home Assistant API is accessible and responding

• ha_check_config

  Validate the Home Assistant configuration. Run this before reloading to catch errors.

• ha_create_areawrite action

  Create a new area (room) in Home Assistant

• ha_create_automationwrite action

  Create a new automation in Home Assistant

• ha_create_backupwrite action

  Create a Home Assistant backup

• ha_create_dashboardwrite action

  Create a new Lovelace dashboard

• ha_create_helperwrite action

  Create a new input helper (input_boolean, input_number, input_text, input_select, input_datetime, input_button, counter, timer)

• ha_create_scenewrite action

  Create a new scene in Home Assistant

• ha_create_scriptwrite action

  Create a new script in Home Assistant

• ha_delete_automationwrite action

  Delete an automation

• ha_delete_dashboardwrite action

  Delete a Lovelace dashboard

• ha_delete_filewrite action

  Delete a file from the Home Assistant server. Path is relative to /config/. Restricted to safe directories.

• ha_delete_helperwrite action

  Delete an input helper

• ha_delete_scenewrite action

  Delete a scene

• ha_delete_scriptwrite action

  Delete a script

• ha_delete_statewrite action

  Delete an entity state from Home Assistant

• ha_file_exists

  Check if a file or directory exists on the Home Assistant server. Path is relative to /config/.

• ha_fire_event

  Fire a custom event in Home Assistant to trigger automations or integrations

• ha_get_automation

  Get the full configuration of an automation by its ID

• ha_get_calendar_events

  Get events from a specific calendar entity

• ha_get_calendars

  List all calendar entities in Home Assistant

• ha_get_components

  List all currently loaded Home Assistant integrations/components

• ha_get_config

  Get the Home Assistant configuration (location, unit system, version, components, etc.)

• ha_get_dashboard_config

  Get the full Lovelace configuration of a dashboard (all views, cards, etc.)

• ha_get_entity

  Get the full state and attributes of a specific entity

• ha_get_error_log

  Get the Home Assistant error log contents

• ha_get_events

  List all available event types in Home Assistant

• ha_get_history

  Get the state history for an entity over a time period

• ha_get_logbook

  Get logbook entries (activity log) for a time period, optionally filtered by entity

• ha_get_states

  Get the current state of all entities, optionally filtered by domain (e.g. 'light', 'switch', 'sensor')

• ha_handle_intent

  Handle a conversation/voice intent in Home Assistant (e.g. natural language commands)

• ha_install_addon

  Install a Home Assistant add-on by slug

• ha_list_addons

  List all installed Home Assistant add-ons with their status

• ha_list_areas

  List all areas (rooms) in Home Assistant

• ha_list_automations

  List all automations in Home Assistant with their IDs, aliases, and states

• ha_list_backups

  List all Home Assistant backups

• ha_list_dashboards

  List all Lovelace dashboards in Home Assistant

• ha_list_devices

  List all devices from the device registry

• ha_list_entity_registry

  List all entities from the entity registry with their IDs, names, platforms, and areas

• ha_list_files

  List files and directories on the Home Assistant server. Path is relative to /config/ (e.g. 'www' lists /config/www/).

• ha_list_helpers

  List all input helpers (input_boolean, input_number, input_text, input_select, input_datetime, input_button, counter, timer)

• ha_list_scenes

  List all scenes in Home Assistant

• ha_list_scripts

  List all scripts in Home Assistant

• ha_list_services

  List all available services, optionally filtered by domain

• ha_mkdirwrite action

  Create a directory on the Home Assistant server (recursively). Path is relative to /config/.

• ha_read_file

  Read a file from the Home Assistant server. Path is relative to /config/.

• ha_render_template

  Render a Jinja2 template using Home Assistant's template engine

• ha_restart_addon

  Restart a Home Assistant add-on

• ha_restart_core

  Restart the Home Assistant core. This will briefly make HA unavailable.

• ha_save_dashboard_config

  Save/overwrite the full Lovelace configuration of a dashboard. Provide the complete config with views and cards.

• ha_set_state

  Set or create the state of an entity. Useful for creating virtual sensors or overriding states.

• ha_start_addon

  Start a Home Assistant add-on

• ha_stop_addon

  Stop a running Home Assistant add-on

• ha_system_info

  Get Home Assistant system information (core version, OS, supervisor, host info)

• ha_uninstall_addon

  Uninstall a Home Assistant add-on

• ha_update_automationwrite action

  Update an existing automation's configuration

• ha_update_core_configwrite action

  Update Home Assistant core configuration (internal_url, external_url, location, etc.)

• ha_update_dashboardwrite action

  Update an existing Lovelace dashboard's properties (title, icon, etc.)

• ha_update_helperwrite action

  Update an existing input helper's configuration

• ha_update_scenewrite action

  Update an existing scene's configuration

• ha_update_scriptwrite action

  Update an existing script's configuration

• ha_upload_filewrite action

  Upload a file from the local machine to the Home Assistant server. Remote path is relative to /config/. Restricted to safe directories (www/, custom_components/, blueprints/, themes/).

• ha_upload_file_contentwrite action

  Create/overwrite a file on the Home Assistant server with the provided text content. Remote path is relative to /config/. Parent directories are created automatically.

• Code scan22 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 170 days ago8/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

72/100

higher than 38% of 48,273 servers

Tools

66

the typical server has 7

Tools that change things

35%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

116

more than 67% of 11,915 servers with a package

Home Assistant MCP Server: common questions

Is Home Assistant MCP Server safe?

Mostly: it is graded B (72/100). Read the Home Assistant MCP Server safety report

How do I install Home Assistant MCP Server?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Home Assistant MCP Server need an API key?

Yes. The registry entry asks for HA_TOKEN, HA_SSH_PASSWORD.

Is Home Assistant MCP Server maintained?

The last commit was 206 days ago (2026-04-10). The latest release is v1.0.6.

How does Home Assistant MCP Server compare with other MCP servers?

safety score 72/100 (higher than 38% of 48,273 servers); tools 66 (the typical server has 7); tools that change things 35% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.