DOCS BLOG ABOUT TRY THE GATEWAY

// MCP TOOL REFERENCE

HOME ASSISTANT TOOLS

96 tools from the Home Assistant MCP Server, categorised by risk level.

View the Home Assistant policy →

// ALL 96 HOME ASSISTANT TOOLS

READ 46 tools

Read ha_analyze_entities_for_dashboard [READ-ONLY] Get entities for AI-driven dashboard generation with pagination/filtering. Safe operation - onl... Read ha_check_config [READ-ONLY] Validate Home Assistant configuration. Safe operation - only checks, does not modify. Read ha_check_theme_config [READ-ONLY] Check if themes are configured in configuration.yaml. Safe operation - only reads data. Read ha_find_dead_entities [READ-ONLY] Find Read ha_get_addon_options [READ-ONLY] Get add-on configuration options. Safe operation - only reads data. Read ha_get_area_registry [READ-ONLY] Get areas from Area Registry with pagination/filtering. Safe operation - only reads data. If ha... Read ha_get_area_registry_entry [READ-ONLY] Get single area from Area Registry. Safe operation - only reads data. Read ha_get_automation [READ-ONLY] Get configuration for a single automation from automations.yaml by automation_id. Safe operatio... Read ha_get_calendar_events [READ-ONLY] Get events from a calendar entity for a date range. Safe operation. Read ha_get_device_registry [READ-ONLY] Get devices from Device Registry with metadata and pagination/filtering. Safe operation - only ... Read ha_get_device_registry_entry [READ-ONLY] Get single device from Device Registry with optional entities list. Safe operation - only reads... Read ha_get_entity_registry [READ-ONLY] Get entities from Entity Registry with metadata (area_id, device_id, name, disabled status, etc... Read ha_get_entity_registry_entry [READ-ONLY] Get single entity from Entity Registry with metadata. Safe operation - only reads data. Read ha_get_entity_state [READ-ONLY] Get entity state and attributes. Safe operation - only reads data. Read ha_get_history [READ-ONLY] Get state history for an entity over a time period. Safe operation. Use to analyze trends, chec... Read ha_get_logs [READ-ONLY] Get agent logs to troubleshoot issues. Safe operation - only reads data. Read ha_get_repairs [READ-ONLY] Get Home Assistant repair issues (configuration problems, deprecations, broken integrations). S... Read ha_get_script [READ-ONLY] Get configuration for a single script from scripts.yaml by script_id. Safe operation - only rea... Read ha_get_snapshot [READ-ONLY] Get an aggregated snapshot of the Home Assistant instance: entity states, areas, devices, integ... Read ha_get_statistics [READ-ONLY] Get long-term statistics for an entity (energy consumption, temperature trends, etc.). Safe ope... Read ha_get_theme [READ-ONLY] Get theme content and configuration. Safe operation - only reads data. Read ha_git_diff [READ-ONLY] Show differences between commits. Safe operation - only reads data. Read ha_git_history [READ-ONLY] Get Git commit history. Safe operation - only reads data. Read ha_git_pending [READ-ONLY] Get information about uncommitted changes in shadow repository. Useful when git_versioning_auto... Read ha_hacs_list_repositories [READ-ONLY] List available HACS repositories (integrations, themes, plugins) with pagination/filtering. Req... Read ha_hacs_repository_details [READ-ONLY] Get detailed information about a specific HACS repository (stars, authors, versions, etc). Safe... Read ha_hacs_search [READ-ONLY] Search HACS repositories by name, author, or description. If HACS not installed yet, use ha_hac... Read ha_hacs_status [READ-ONLY] Check if HACS is installed and get version info. ALWAYS call this FIRST when user mentions HACS... Read ha_list_addons [READ-ONLY] List available Home Assistant add-ons with pagination/filtering. Safe operation - only reads da... Read ha_list_automations [READ-ONLY] List automations in Home Assistant with pagination/filtering. Safe operation - only reads data.... Read ha_list_blueprints [READ-ONLY] List available automation or script blueprints. Safe operation. Use to find community-shared te... Read ha_list_calendars [READ-ONLY] List all calendar entities. Safe operation. Read ha_list_entities [READ-ONLY] List entities in Home Assistant with optional filters, pagination and lightweight modes. Safe o... Read ha_list_exposed_entities [READ-ONLY] List entities exposed to a voice assistant (Assist/Ollama, Alexa, Google Assistant). Safe opera... Read ha_list_files [READ-ONLY] List files and directories in Home Assistant with pagination support. Safe operation - only rea... Read ha_list_helpers [READ-ONLY] List helpers in Home Assistant with pagination/filtering. Safe operation - only reads data. If ... Read ha_list_installed_addons [READ-ONLY] List only installed add-ons. Safe operation - only reads data. Read ha_list_repositories [READ-ONLY] List all add-on repositories connected to Home Assistant. Shows which sources provide available... Read ha_list_scripts [READ-ONLY] List scripts in Home Assistant with pagination/filtering. Safe operation - only reads data. Def... Read ha_list_store_addons [READ-ONLY] List add-ons from add-on store catalog with pagination/filtering. Safe operation - only reads d... Read ha_list_themes [READ-ONLY] List all available themes in Home Assistant. Safe operation - only reads data. Read ha_list_todos [READ-ONLY] Get items from a todo list entity. Safe operation. Read ha_list_zones [READ-ONLY] List all zones configured in Home Assistant (used for presence detection). Safe operation. Read ha_logbook_entries [READ-ONLY] Fetch Home Assistant logbook entries for analyzing automations, scripts, and other events. Read ha_preview_dashboard [READ-ONLY] Preview current Lovelace dashboard configuration. Shows existing ui-lovelace.yaml if configured... Read ha_read_file [READ-ONLY] Read a file from Home Assistant configuration directory. Safe operation - only reads data.

WRITE 33 tools

Write ha_add_repository [WRITE] Add a custom add-on repository to Home Assistant. MODIFIES configuration - requires approval. Use t... Write ha_addon_info [READ-ONLY] Get detailed information about a specific add-on (configuration, state, version, etc). Safe ope... Write ha_addon_logs [READ-ONLY] Get add-on logs for troubleshooting. Safe operation - only reads data. Write ha_apply_dashboard [WRITE] Apply generated dashboard configuration to Home Assistant. Creates file, auto-registers in configur... Write ha_call_service [WRITE] Call a Home Assistant service. MODIFIES system state - requires approval. Examples: number.set_valu... Write ha_create_area [WRITE] Create new area in Area Registry. MODIFIES area registry - requires approval. Write ha_create_automation [WRITE] Create new automation in Home Assistant. MODIFIES configuration - requires approval. Provide a mean... Write ha_create_checkpoint [WRITE] Create checkpoint with tag at the start of user request processing. This should be called automatic... Write ha_create_helper [WRITE] Create a Home Assistant helper via YAML configuration. MODIFIES configuration - requires approval. ... Write ha_create_script [WRITE] Create new script in Home Assistant. MODIFIES configuration - requires approval. Provide a meaningf... Write ha_create_theme [WRITE] Create a new theme in Home Assistant. MODIFIES configuration - requires approval. After creation, c... Write ha_create_todo [WRITE] Add an item to a todo list. MODIFIES data. Write ha_create_zone [WRITE] Create a new zone for presence detection. MODIFIES configuration. Write ha_end_checkpoint [WRITE] End request processing checkpoint. Re-enables auto-commits. Should be called at the end of user req... Write ha_git_commit [WRITE] Commit configuration to Git. Creates backup snapshot. If message is not provided and git_versioning... Write ha_git_rollback [WRITE] Rollback configuration to specific commit. DESTRUCTIVE - requires approval! Write ha_hacs_install_repository [WRITE] Install integration/theme/plugin from HACS. Requires HACS to be installed. MODIFIES configuration -... Write ha_hacs_update_all [WRITE] Update all installed HACS repositories to latest versions. Home Assistant restart required after up... Write ha_import_blueprint [WRITE] Import a blueprint from a URL (community forum, GitHub). MODIFIES configuration. Write ha_install_addon [WRITE] Install a Home Assistant add-on. MODIFIES system - requires approval. Installation can take several... Write ha_install_hacs [WRITE] Install HACS (Home Assistant Community Store). Downloads latest HACS from GitHub, installs to custo... Write ha_reload_config [WRITE] Reload Home Assistant configuration. APPLIES changes - requires approval! Write ha_reload_themes [WRITE] Reload themes in Home Assistant. MODIFIES system state - requires approval. Calls frontend.reload_t... Write ha_rename_entity [WRITE] Rename an entity_id in Home Assistant via Entity Registry. MODIFIES entity registry - requires appr... Write ha_set_addon_options [WRITE] Set add-on configuration options. MODIFIES configuration - requires approval. Add-on may need restart. Write ha_update_addon [WRITE] Update an add-on to latest version. MODIFIES system - requires approval. Update can take several mi... Write ha_update_area [WRITE] Update area in Area Registry. MODIFIES area registry - requires approval. Write ha_update_automation [WRITE] Update existing automation in Home Assistant. MODIFIES configuration - requires approval. Provide a... Write ha_update_device_registry [WRITE] Update device in Device Registry (area_id, name_by_user, disabled_by, etc.). MODIFIES device regist... Write ha_update_entity_registry [WRITE] Update entity in Entity Registry (name, area_id, disabled status, etc.). MODIFIES entity registry -... Write ha_update_script [WRITE] Update existing script in Home Assistant. MODIFIES configuration - requires approval. Provide a mea... Write ha_update_theme [WRITE] Update an existing theme in Home Assistant. MODIFIES configuration - requires approval. After updat... Write ha_write_file [WRITE] Write content to a file in Home Assistant. MODIFIES configuration - requires approval. Provide a me...

DESTRUCTIVE 12 tools

Destructive ha_delete_area [WRITE] Delete area from Area Registry. MODIFIES area registry - requires approval. Destructive ha_delete_automation [WRITE] Delete automation from Home Assistant. MODIFIES configuration - requires approval. Destructive ha_delete_dashboard [WRITE] Delete dashboard file and remove from configuration.yaml. Restarts Home Assistant. Creates automati... Destructive ha_delete_file [WRITE] Delete a file from Home Assistant. DESTRUCTIVE - requires approval! Destructive ha_delete_helper [WRITE] Delete a Home Assistant helper from YAML configuration. MODIFIES configuration - requires approval. Destructive ha_delete_script [WRITE] Delete script from Home Assistant. MODIFIES configuration - requires approval. Destructive ha_delete_theme [WRITE] Delete a theme from Home Assistant. DESTRUCTIVE - requires approval! After deletion, call ha_reload... Destructive ha_delete_zone [WRITE] Delete a zone. MODIFIES configuration. Destructive ha_remove_device_registry_entry [WRITE] Remove device from Device Registry. MODIFIES device registry - requires approval. Destructive ha_remove_entity_registry_entry [WRITE] Remove entity from Entity Registry. MODIFIES entity registry - requires approval. Destructive ha_uninstall_addon [WRITE] Uninstall a Home Assistant add-on. DESTRUCTIVE - requires approval! Removes add-on and its data. Destructive ha_uninstall_hacs [WRITE] Uninstall HACS (Home Assistant Community Store). Removes HACS directory, storage files, and restart...

EXECUTE 5 tools

Execute ha_expose_entities [WRITE] Expose or unexpose entities to a voice assistant. MODIFIES voice assistant configuration - requires... Execute ha_restart [WRITE] FULL restart of Home Assistant. Completely restarts HA Core. Use when configuration changes require... Execute ha_restart_addon [WRITE] Restart an add-on. MODIFIES system - requires approval. Execute ha_start_addon [WRITE] Start an add-on. MODIFIES system - requires approval. Execute ha_stop_addon [WRITE] Stop a running add-on. MODIFIES system - requires approval.

// RUNNING THIS SERVER

The managed route: connect Home Assistant through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @coolver/home-assistant-mcp

// FAQ

How many tools does the Home Assistant MCP server have? +

The Home Assistant MCP server exposes 96 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Home Assistant tools? +

Route the Home Assistant server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Home Assistant tools fall into? +

Home Assistant tools are categorised as Read (46), Write (33), Destructive (12), Execute (5). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.