MCP Home Assistant

import { Tool } from '@modelcontextprotocol/sdk/types.js'; export const tools: Tool[] = [ // File Operations (Read-only) { name: 'ha_read_file', description: '[READ-ONLY] Read a file from Home Assistant configuration directory. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to the file relative to /config (e.g., "configuration.yaml", "automations.yaml", "scripts/my_script.yaml")', }, }, required: ['path'], }, }, { name: 'ha_write_file', description: '[WRITE] Write content to a file in Home Assistant. MODIFIES configuration - requires approval. Provide a meaningful description of what and why you are changing (e.g., "Add motion sensor automation", "Fix temperature threshold", "Update dashboard layout").', inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to the file relative to /config', }, content: { type: 'string', description: 'Content to write to the file', }, description: { type: 'string', description: 'Optional: Human-readable description of what and why you are changing (e.g., "Add automation for motion sensor light control", "Fix temperature threshold in climate automation", "Update dashboard to show new sensors"). This will be used in Git commit message.', }, }, required: ['path', 'content'], }, }, { name: 'ha_list_files', description: '[READ-ONLY] List files and directories in Home Assistant. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { directory: { type: 'string', description: 'Directory path relative to /config (default: "/")', }, }, }, }, { name: 'ha_delete_file', description: '[WRITE] Delete a file from Home Assistant. DESTRUCTIVE - requires approval!', inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Path to the file to delete', }, }, required: ['path'], }, }, // Entity Operations (Read-only) { name: 'ha_list_entities', description: '[READ-ONLY] List all entities in Home Assistant. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { domain: { type: 'string', description: 'Optional domain filter (e.g., "light", "climate", "sensor")', }, }, }, }, { name: 'ha_get_entity_state', description: '[READ-ONLY] Get entity state and attributes. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { entity_id: { type: 'string', description: 'Entity ID (e.g., "light.living_room", "climate.bedroom")', }, }, required: ['entity_id'], }, }, { name: 'ha_rename_entity', description: '[WRITE] Rename an entity_id in Home Assistant via Entity Registry. MODIFIES entity registry - requires approval. After renaming, you may need to reload automations/scripts that reference the entity.', inputSchema: { type: 'object', properties: { old_entity_id: { type: 'string', description: 'Current entity_id (e.g., "climate.sonoff_trvzb_thermostat")', }, new_entity_id: { type: 'string', description: 'New entity_id (e.g., "climate.office_trv_thermostat")', }, }, required: ['old_entity_id', 'new_entity_id'], }, }, // Entity Registry Operations { name: 'ha_get_entity_registry', description: '[READ-ONLY] Get all entities from Entity Registry with metadata (area_id, device_id, name, disabled status, etc.). Safe operation - only reads data. Use this to get area assignments and other metadata not available in ha_list_entities.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_get_entity_registry_entry', description: '[READ-ONLY] Get single entity from Entity Registry with metadata. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { entity_id: { type: 'string', description: 'Entity ID (e.g., "climate.bedroom_trv")', }, }, required: ['entity_id'], }, }, { name: 'ha_update_entity_registry', description: '[WRITE] Update entity in Entity Registry (name, area_id, disabled status, etc.). MODIFIES entity registry - requires approval.', inputSchema: { type: 'object', properties: { entity_id: { type: 'string', description: 'Entity ID to update', }, name: { type: 'string', description: 'New friendly name', }, area_id: { type: 'string', description: 'Area ID to assign entity to', }, disabled: { type: 'boolean', description: 'Disable/enable entity', }, new_entity_id: { type: 'string', description: 'New entity_id (rename)', }, icon: { type: 'string', description: 'Icon for entity', }, aliases: { type: 'array', items: { type: 'string' }, description: 'Aliases for entity', }, }, required: ['entity_id'], }, }, { name: 'ha_remove_entity_registry_entry', description: '[WRITE] Remove entity from Entity Registry. MODIFIES entity registry - requires approval.', inputSchema: { type: 'object', properties: { entity_id: { type: 'string', description: 'Entity ID to remove from registry', }, }, required: ['entity_id'], }, }, { name: 'ha_find_dead_entities', description: '[READ-ONLY] Find "dead" entities in Entity Registry. Compares entities in registry (automation.* and script.*) with automations and scripts defined in YAML files to identify entities that exist in registry but are missing from YAML configuration. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, // Area Registry Operations { name: 'ha_get_area_registry', description: '[READ-ONLY] Get all areas from Area Registry. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_get_area_registry_entry', description: '[READ-ONLY] Get single area from Area Registry. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { area_id: { type: 'string', description: 'Area ID', }, }, required: ['area_id'], }, }, { name: 'ha_create_area', description: '[WRITE] Create new area in Area Registry. MODIFIES area registry - requires approval.', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Area name (e.g., "Living Room")', }, aliases: { type: 'array', items: { type: 'string' }, description: 'Optional aliases for area', }, }, required: ['name'], }, }, { name: 'ha_update_area', description: '[WRITE] Update area in Area Registry. MODIFIES area registry - requires approval.', inputSchema: { type: 'object', properties: { area_id: { type: 'string', description: 'Area ID to update', }, name: { type: 'string', description: 'New area name', }, aliases: { type: 'array', items: { type: 'string' }, description: 'New aliases list', }, }, required: ['area_id'], }, }, { name: 'ha_delete_area', description: '[WRITE] Delete area from Area Registry. MODIFIES area registry - requires approval.', inputSchema: { type: 'object', properties: { area_id: { type: 'string', description: 'Area ID to delete', }, }, required: ['area_id'], }, }, // Device Registry Operations { name: 'ha_get_device_registry', description: '[READ-ONLY] Get all devices from Device Registry with metadata (area_id, name, manufacturer, model, etc.). Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_get_device_registry_entry', description: '[READ-ONLY] Get single device from Device Registry. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { device_id: { type: 'string', description: 'Device ID', }, }, required: ['device_id'], }, }, { name: 'ha_update_device_registry', description: '[WRITE] Update device in Device Registry (area_id, name_by_user, disabled_by, etc.). MODIFIES device registry - requires approval.', inputSchema: { type: 'object', properties: { device_id: { type: 'string', description: 'Device ID to update', }, area_id: { type: 'string', description: 'Area ID to assign device to', }, name_by_user: { type: 'string', description: 'Custom name for device', }, disabled_by: { type: 'string', description: 'Disable device (set to "user" to disable)', }, }, required: ['device_id'], }, }, { name: 'ha_remove_device_registry_entry', description: '[WRITE] Remove device from Device Registry. MODIFIES device registry - requires approval.', inputSchema: { type: 'object', properties: { device_id: { type: 'string', description: 'Device ID to remove from registry', }, }, required: ['device_id'], }, }, // Helper Operations { name: 'ha_list_helpers', description: '[READ-ONLY] List all helpers in Home Assistant. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_create_helper', description: '[WRITE] Create a Home Assistant helper via YAML configuration. MODIFIES configuration - requires approval. Helper will be created in YAML file and reloaded automatically. Provide a meaningful description of what the helper is for (e.g., "Enable/disable climate system", "Set target temperature").', inputSchema: { type: 'object', properties: { type: { type: 'string', enum: ['input_boolean', 'input_text', 'input_number', 'input_datetime', 'input_select'], description: 'Helper type', }, config: { type: 'object', description: 'Helper configuration (must include "name" field)', }, description: { type: 'string', description: 'Optional: Human-readable description of what the helper is for and why (e.g., "Enable/disable climate system control", "Set target temperature for living room"). This will be used in Git commit message.', }, }, required: ['type', 'config'], }, }, { name: 'ha_delete_helper', description: '[WRITE] Delete a Home Assistant helper from YAML configuration. MODIFIES configuration - requires approval.', inputSchema: { type: 'object', properties: { entity_id: { type: 'string', description: 'Full entity ID of helper to delete (e.g., "input_boolean.my_switch")', }, }, required: ['entity_id'], }, }, // Automation Operations { name: 'ha_create_automation', description: '[WRITE] Create new automation in Home Assistant. MODIFIES configuration - requires approval. Provide a meaningful description of what the automation does (e.g., "Control lights based on motion", "Adjust temperature based on schedule").', inputSchema: { type: 'object', properties: { config: { type: 'object', description: 'Automation configuration (id, alias, trigger, condition, action)', }, description: { type: 'string', description: 'Optional: Human-readable description of what the automation does and why (e.g., "Control living room lights when motion detected", "Adjust bedroom temperature based on schedule", "Turn off all lights when leaving home"). This will be used in Git commit message.', }, }, required: ['config'], }, }, { name: 'ha_list_automations', description: '[READ-ONLY] List all automations in Home Assistant. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_delete_automation', description: '[WRITE] Delete automation from Home Assistant. MODIFIES configuration - requires approval.', inputSchema: { type: 'object', properties: { automation_id: { type: 'string', description: 'Automation ID to delete (e.g., "my_automation")', }, }, required: ['automation_id'], }, }, // Script Operations { name: 'ha_create_script', description: '[WRITE] Create new script in Home Assistant. MODIFIES configuration - requires approval. Provide a meaningful description of what the script does (e.g., "Start morning routine", "Control climate system").', inputSchema: { type: 'object', properties: { config: { type: 'object', description: 'Script configuration object', }, description: { type: 'string', description: 'Optional: Human-readable description of what the script does and why (e.g., "Start morning routine: turn on lights and adjust temperature", "Control climate system startup sequence"). This will be used in Git commit message.', }, }, required: ['config'], }, }, { name: 'ha_list_scripts', description: '[READ-ONLY] List all scripts in Home Assistant. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_delete_script', description: '[WRITE] Delete script from Home Assistant. MODIFIES configuration - requires approval.', inputSchema: { type: 'object', properties: { script_id: { type: 'string', description: 'Script ID to delete (e.g., "my_script")', }, }, required: ['script_id'], }, }, // Git/Backup Operations { name: 'ha_git_commit', description: '[WRITE] Commit configuration to Git. Creates backup snapshot. If message is not provided and git_versioning_auto=false, returns suggested commit message that needs user confirmation.', inputSchema: { type: 'object', properties: { message: { type: 'string', description: 'Commit message describing the changes. If omitted and git_versioning_auto=false, the API will return a suggested message that you should show to the user for confirmation/editing before committing.', }, }, }, }, { name: 'ha_git_pending', description: '[READ-ONLY] Get information about uncommitted changes in shadow repository. Useful when git_versioning_auto=false to see what changes are pending commit. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_git_history', description: '[READ-ONLY] Get Git commit history. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Number of commits to retrieve (default: 20)', }, }, }, }, { name: 'ha_git_rollback', description: '[WRITE] Rollback configuration to specific commit. DESTRUCTIVE - requires approval!', inputSchema: { type: 'object', properties: { commit_hash: { type: 'string', description: 'Git commit hash to rollback to', }, }, required: ['commit_hash'], }, }, { name: 'ha_create_checkpoint', description: '[WRITE] Create checkpoint with tag at the start of user request processing. This should be called automatically at the beginning of each user request to save current state before making changes. Creates a commit and tag with timestamp and user request description. Disables auto-commits during request processing.', inputSchema: { type: 'object', properties: { user_request: { type: 'string', description: 'Description of the user request (e.g., "Create nice_dark theme with dark blue header")', }, }, required: ['user_request'], }, }, { name: 'ha_end_checkpoint', description: '[WRITE] End request processing checkpoint. Re-enables auto-commits. Should be called at the end of user request processing.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_git_diff', description: '[READ-ONLY] Show differences between commits. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { commit1: { type: 'string', description: 'First commit hash (optional). If omitted, shows uncommitted changes', }, commit2: { type: 'string', description: 'Second commit hash (optional). If omitted with commit1, shows changes since commit1 to HEAD', }, }, }, }, // System Operations { name: 'ha_check_config', description: '[READ-ONLY] Validate Home Assistant configuration. Safe operation - only checks, does not modify.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_reload_config', description: '[WRITE] Reload Home Assistant configuration. APPLIES changes - requires approval!', inputSchema: { type: 'object', properties: { component: { type: 'string', description: 'Component to reload: "automations", "scripts", "templates", "core", or "all" (default: "all")', enum: ['automations', 'scripts', 'templates', 'core', 'all'], }, }, }, }, { name: 'ha_restart', description: '[WRITE] FULL restart of Home Assistant. Completely restarts HA Core. Use when configuration changes require full restart (e.g., new dashboards, integrations). HA will be unavailable for 30-60 seconds. DISRUPTIVE - requires approval!', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_get_logs', description: '[READ-ONLY] Get agent logs to troubleshoot issues. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Number of log entries to retrieve (default: 100)', }, level: { type: 'string', description: 'Filter by log level: DEBUG, INFO, WARNING, ERROR (optional)', enum: ['DEBUG', 'INFO', 'WARNING', 'ERROR'], }, }, }, }, { name: 'ha_logbook_entries', description: '[READ-ONLY] Fetch Home Assistant logbook entries for analyzing automations, scripts, and other events.', inputSchema: { type: 'object', properties: { start_time: { type: 'string', description: 'ISO timestamp (UTC) for the start of the window. Optional if lookback_minutes is provided.', }, end_time: { type: 'string', description: 'ISO timestamp (UTC) for the end of the window. Defaults to now.', }, lookback_minutes: { type: 'number', description: 'Lookback window in minutes when start_time is omitted (default: 120).', }, limit: { type: 'number', description: 'Maximum number of entries to return (default: 100).', }, entity_id: { type: 'string', description: 'Filter by a single entity_id (e.g., "script.my_script").', }, entity_ids: { type: 'array', description: 'List of entity_ids to include (comma-separated or repeated query values).', items: { type: 'string' }, }, domains: { type: 'array', description: 'Filter by domains (e.g., automation, script, light).', items: { type: 'string' }, }, event_types: { type: 'array', description: 'Filter by logbook event types (e.g., automation_triggered, script_started).', items: { type: 'string' }, }, search: { type: 'string', description: 'Case-insensitive search string for name/message/entity_id.', }, }, }, }, { name: 'ha_install_hacs', description: '[WRITE] Install HACS (Home Assistant Community Store). Downloads latest HACS from GitHub, installs to custom_components, and restarts Home Assistant. Opens access to 1000+ integrations. MODIFIES configuration - requires approval!', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_uninstall_hacs', description: '[WRITE] Uninstall HACS (Home Assistant Community Store). Removes HACS directory, storage files, and restarts Home Assistant. DESTRUCTIVE - requires approval!', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_hacs_status', description: '[READ-ONLY] Check if HACS is installed and get version info. ALWAYS call this FIRST when user mentions HACS or asks about custom integrations. If not installed, offer to install via ha_install_hacs. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_hacs_list_repositories', description: '[READ-ONLY] List available HACS repositories (integrations, themes, plugins). Requires HACS to be installed and configured. If HACS not installed, use ha_hacs_status first and offer installation. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_hacs_install_repository', description: '[WRITE] Install integration/theme/plugin from HACS. Requires HACS to be installed. MODIFIES configuration - requires approval!', inputSchema: { type: 'object', properties: { repository: { type: 'string', description: 'Repository name to install (e.g., "AlexxIT/XiaomiGateway3")', }, category: { type: 'string', description: 'Repository category: integration, theme, plugin, appdaemon, netdaemon, python_script (default: integration)', enum: ['integration', 'theme', 'plugin', 'appdaemon', 'netdaemon', 'python_script'], }, }, required: ['repository'], }, }, { name: 'ha_hacs_search', description: '[READ-ONLY] Search HACS repositories by name, author, or description. If HACS not installed yet, use ha_hacs_status first and offer to install HACS. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'Search query (e.g., "xiaomi", "gateway", "sensor")', }, category: { type: 'string', description: 'Filter by category (optional)', enum: ['integration', 'theme', 'plugin', 'appdaemon', 'netdaemon', 'python_script'], }, }, required: ['query'], }, }, { name: 'ha_hacs_update_all', description: '[WRITE] Update all installed HACS repositories to latest versions. Home Assistant restart required after updates. MODIFIES configuration - requires approval!', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_hacs_repository_details', description: '[READ-ONLY] Get detailed information about a specific HACS repository (stars, authors, versions, etc). Safe operation - only reads data.', inputSchema: { type: 'object', properties: { repository_id: { type: 'string', description: 'Repository identifier (e.g., "AlexxIT/XiaomiGateway3" or part of entity_id)', }, }, required: ['repository_id'], }, }, // ==================== Add-on Management ==================== { name: 'ha_list_store_addons', description: '[READ-ONLY] List ALL add-ons from add-on store catalog (complete list from all repositories). Use this to browse available add-ons and make recommendations. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_list_addons', description: '[READ-ONLY] List available Home Assistant add-ons (limited list). For complete catalog, use ha_list_store_addons. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_list_installed_addons', description: '[READ-ONLY] List only installed add-ons. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_addon_info', description: '[READ-ONLY] Get detailed information about a specific add-on (configuration, state, version, etc). Safe operation - only reads data.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug (e.g., "core_mosquitto", "a0d7b954_zigbee2mqtt")', }, }, required: ['slug'], }, }, { name: 'ha_addon_logs', description: '[READ-ONLY] Get add-on logs for troubleshooting. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug', }, lines: { type: 'number', description: 'Number of log lines to return (default: 100)', }, }, required: ['slug'], }, }, { name: 'ha_install_addon', description: '[WRITE] Install a Home Assistant add-on. MODIFIES system - requires approval. Installation can take several minutes.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug to install (e.g., "core_mosquitto" for Mosquitto MQTT, "a0d7b954_zigbee2mqtt" for Zigbee2MQTT)', }, }, required: ['slug'], }, }, { name: 'ha_uninstall_addon', description: '[WRITE] Uninstall a Home Assistant add-on. DESTRUCTIVE - requires approval! Removes add-on and its data.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug to uninstall', }, }, required: ['slug'], }, }, { name: 'ha_start_addon', description: '[WRITE] Start an add-on. MODIFIES system - requires approval.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug to start', }, }, required: ['slug'], }, }, { name: 'ha_stop_addon', description: '[WRITE] Stop a running add-on. MODIFIES system - requires approval.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug to stop', }, }, required: ['slug'], }, }, { name: 'ha_restart_addon', description: '[WRITE] Restart an add-on. MODIFIES system - requires approval.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug to restart', }, }, required: ['slug'], }, }, { name: 'ha_update_addon', description: '[WRITE] Update an add-on to latest version. MODIFIES system - requires approval. Update can take several minutes.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug to update', }, }, required: ['slug'], }, }, { name: 'ha_get_addon_options', description: '[READ-ONLY] Get add-on configuration options. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug', }, }, required: ['slug'], }, }, { name: 'ha_set_addon_options', description: '[WRITE] Set add-on configuration options. MODIFIES configuration - requires approval. Add-on may need restart.', inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'Add-on slug', }, options: { type: 'object', description: 'Configuration options to set (key-value pairs)', }, }, required: ['slug', 'options'], }, }, { name: 'ha_list_repositories', description: '[READ-ONLY] List all add-on repositories connected to Home Assistant. Shows which sources provide available add-ons. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_add_repository', description: '[WRITE] Add a custom add-on repository to Home Assistant. MODIFIES configuration - requires approval. Use to add community repositories with popular add-ons (Zigbee2MQTT, Node-RED, ESPHome, etc).', inputSchema: { type: 'object', properties: { repository_url: { type: 'string', description: 'Repository URL to add (e.g., https://github.com/hassio-addons/repository)', }, }, required: ['repository_url'], }, }, // ==================== Lovelace Dashboard ==================== { name: 'ha_analyze_entities_for_dashboard', description: '[READ-ONLY] Get complete entity list for AI-driven dashboard generation. Returns entities grouped by domain with attributes. AI will use this data to generate custom dashboard based on user requirements. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_preview_dashboard', description: '[READ-ONLY] Preview current Lovelace dashboard configuration. Shows existing ui-lovelace.yaml if configured. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_apply_dashboard', description: '[WRITE] Apply generated dashboard configuration to Home Assistant. Creates file, auto-registers in configuration.yaml, and restarts HA. Creates automatic Git backup. MODIFIES configuration - requires approval! Provide a meaningful description of what the dashboard shows (e.g., "Main dashboard with climate and lights", "Overview of all sensors").', inputSchema: { type: 'object', properties: { dashboard_config: { type: 'object', description: 'Dashboard configuration object (from ha_generate_dashboard)', }, create_backup: { type: 'boolean', description: 'Create Git backup before applying (default: true)', }, filename: { type: 'string', description: 'Dashboard filename (default: ai-dashboard.yaml)', }, register_dashboard: { type: 'boolean', description: 'Auto-register dashboard in configuration.yaml (default: true)', }, description: { type: 'string', description: 'Optional: Human-readable description of what the dashboard shows and why (e.g., "Main dashboard with climate controls and lights", "Overview dashboard showing all sensors and devices"). This will be used in Git commit message.', }, }, required: ['dashboard_config'], }, }, { name: 'ha_delete_dashboard', description: '[WRITE] Delete dashboard file and remove from configuration.yaml. Restarts Home Assistant. Creates automatic Git backup. DESTRUCTIVE - requires approval!', inputSchema: { type: 'object', properties: { filename: { type: 'string', description: 'Dashboard filename to delete (e.g., ai-dashboard.yaml)', }, remove_from_config: { type: 'boolean', description: 'Remove from configuration.yaml (default: true)', }, create_backup: { type: 'boolean', description: 'Create Git backup before deleting (default: true)', }, }, required: ['filename'], }, }, // ==================== Service Calls ==================== { name: 'ha_call_service', description: '[WRITE] Call a Home Assistant service. MODIFIES system state - requires approval. Examples: number.set_value, light.turn_on, climate.set_temperature, switch.turn_on, etc.', inputSchema: { type: 'object', properties: { domain: { type: 'string', description: 'Service domain (e.g., "number", "light", "climate", "switch", "input_number")', }, service: { type: 'string', description: 'Service name (e.g., "set_value", "turn_on", "set_temperature", "turn_off")', }, service_data: { type: 'object', description: 'Service data (e.g., {"entity_id": "number.alex_trv_local_temperature_offset", "value": -2.0} for number.set_value)', }, target: { type: 'object', description: 'Target entity/entities (e.g., {"entity_id": "light.living_room"} or {"entity_id": ["light.room1", "light.room2"]})', }, }, required: ['domain', 'service'], }, }, // ==================== Themes ==================== { name: 'ha_list_themes', description: '[READ-ONLY] List all available themes in Home Assistant. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_get_theme', description: '[READ-ONLY] Get theme content and configuration. Safe operation - only reads data.', inputSchema: { type: 'object', properties: { theme_name: { type: 'string', description: 'Theme name (without .yaml extension, e.g., "nice_dark")', }, }, required: ['theme_name'], }, }, { name: 'ha_create_theme', description: '[WRITE] Create a new theme in Home Assistant. MODIFIES configuration - requires approval. After creation, call ha_reload_themes or restart HA. Provide a meaningful description of the theme (e.g., "Dark theme with blue accents", "Light theme for daytime use").', inputSchema: { type: 'object', properties: { theme_name: { type: 'string', description: 'Theme name (without .yaml extension, e.g., "nice_dark")', }, theme_config: { type: 'object', description: 'Theme configuration object with CSS variables (e.g., {"primary-color": "#ffb74d", "accent-color": "#ffb74d", ...})', }, description: { type: 'string', description: 'Optional: Human-readable description of the theme and why it was created (e.g., "Dark theme with blue accents for better visibility", "Light theme optimized for daytime use"). This will be used in Git commit message.', }, }, required: ['theme_name', 'theme_config'], }, }, { name: 'ha_update_theme', description: '[WRITE] Update an existing theme in Home Assistant. MODIFIES configuration - requires approval. After update, call ha_reload_themes or restart HA. Provide a meaningful description of what changed (e.g., "Change primary color to blue", "Adjust contrast for better readability").', inputSchema: { type: 'object', properties: { theme_name: { type: 'string', description: 'Theme name (without .yaml extension, e.g., "nice_dark")', }, theme_config: { type: 'object', description: 'Theme configuration object with CSS variables (e.g., {"primary-color": "#ffb74d", "accent-color": "#ffb74d", ...})', }, description: { type: 'string', description: 'Optional: Human-readable description of what changed and why (e.g., "Change primary color to blue for better visibility", "Adjust contrast for better readability in dark mode"). This will be used in Git commit message.', }, }, required: ['theme_name', 'theme_config'], }, }, { name: 'ha_delete_theme', description: '[WRITE] Delete a theme from Home Assistant. DESTRUCTIVE - requires approval! After deletion, call ha_reload_themes or restart HA.', inputSchema: { type: 'object', properties: { theme_name: { type: 'string', description: 'Theme name (without .yaml extension, e.g., "nice_dark")', }, }, required: ['theme_name'], }, }, { name: 'ha_reload_themes', description: '[WRITE] Reload themes in Home Assistant. MODIFIES system state - requires approval. Calls frontend.reload_themes service.', inputSchema: { type: 'object', properties: {}, }, }, { name: 'ha_check_theme_config', description: '[READ-ONLY] Check if themes are configured in configuration.yaml. Safe operation - only reads data.', inputSchema: { type: 'object', properties: {}, }, }, ];