config.yaml

name: "Home Assistant MCP Server"
description: "AI assistant integration for Home Assistant via Model Context Protocol (MCP)"
version: "7.3.0"
slug: "ha_mcp"
url: "https://github.com/homeassistant-ai/ha-mcp"
arch:
  - aarch64 # 64-bit ARM (Raspberry Pi 4+, modern ARM devices)
  - amd64 # 64-bit x86 (most PCs and servers)
  # Note: 32-bit platforms (armhf, armv7, i386) not supported
  # uv base image only provides amd64 and arm64 builds
init: false
startup: application
boot: manual
# Enable access to Supervisor API for auto-discovery
hassio_api: true
hassio_role: default
# Enable access to Home Assistant API
homeassistant_api: true
# Enable host network mode for local network access
host_network: true
# Use pre-built Docker images
image: "ghcr.io/homeassistant-ai/ha-mcp-addon-{arch}"
# Options for user configuration
# NOTE: enable_yaml_config_editing, enable_filesystem_tools, and
# enable_custom_component_integration are intentionally NOT exposed here.
# They are dev-channel-only beta features — see docs/beta.md. Do not re-mirror
# from homeassistant-addon-dev/config.yaml without reading that doc first.
options:
  backup_hint: "normal"
  enable_skills: true
  enable_skills_as_tools: true
  enable_tool_search: false
schema:
  backup_hint: list(strong|normal|weak|auto)
  secret_path: str?
  enable_skills: bool?
  enable_skills_as_tools: bool?
  enable_tool_search: bool?
# Add-on exposes HTTP port for MCP communication (fixed internal port)
ports:
  9583/tcp: 9583