💬 What Went Wrong?
The HA-MCP Custom Component (ha_mcp_tools) fails to start. When setting up the "HA-MCP Server" config entry, the import fails with a ModuleNotFoundError for voluptuous_openapi. I tried fixing this with a full Home Assistant restart (not just a reload) — no success. I then searched the Home Assistant Core log around the restart for lines containing "pip install", "requirements", or "voluptuous" and found no lines at all referencing ha_mcp_tools. This suggests Home Assistant isn't even attempting to auto-install the requirement.
📋 AI-Generated Content / Logs / Config
Logger: custom_components.ha_mcp_tools
Source: config_entries.py:803
Integration: HA-MCP Custom Component
Error setting up entry HA-MCP Server for ha_mcp_tools
Traceback (most recent call last):
File "/usr/src/homeassistant/homeassistant/config_entries.py", line 803, in __async_setup_with_context
result = await component.async_setup_entry(hass, self)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/config/custom_components/ha_mcp_tools/__init__.py", line 2625, in async_setup_entry
return await async_setup_server_entry(hass, entry)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/config/custom_components/ha_mcp_tools/embedded_entry.py", line 75, in async_setup_server_entry
from .embedded_setup import async_bring_up_server, async_maybe_auto_update
File "/config/custom_components/ha_mcp_tools/embedded_setup.py", line 73, in <module>
from .llm_api import async_register_llm_api, async_unregister_llm_api
File "/config/custom_components/ha_mcp_tools/llm_api.py", line 62, in <module>
from voluptuous_openapi import convert_to_voluptuous
ModuleNotFoundError: No module named 'voluptuous_openapi'🖥️ Client Application
Claude Desktop
📦 Installation Method
Other (specify below)
💻 Operating System
Other
OS Version
HA OS
📖 Setup Guide Followed
https://homeassistant-ai.github.io/ha-mcp/setup/?method=ha-component&client=claude-code&scope=remote&remote=builtin-webhook
🔄 Exact Steps You Followed
installed ha_mcp_tools via HACS (custom repository homeassistant-ai/ha-mcp-integration)
Restarted Home Assistant
Went to Settings → Devices & Services → Add Integration → "HA-MCP Custom Component" → chose entry type "HA-MCP Server"
The error above appeared immediately during config entry setup
Performed a full restart (Settings → System → Restart) — error persisted
Searched the Core log after the restart — found no requirements-installation lines for ha_mcp_tools
🐍 Python Version
No response
📦 ha-mcp Version
latest
🏠 Home Assistant Version
2026.9.0b0
💡 Additional Context
Note: running Home Assistant Core 2026.9.0b0 (beta) — happy to test on stable if that helps narrow it down.
I know it is beta, just as a heads up
💬 What Went Wrong?
The HA-MCP Custom Component (ha_mcp_tools) fails to start. When setting up the "HA-MCP Server" config entry, the import fails with a ModuleNotFoundError for voluptuous_openapi. I tried fixing this with a full Home Assistant restart (not just a reload) — no success. I then searched the Home Assistant Core log around the restart for lines containing "pip install", "requirements", or "voluptuous" and found no lines at all referencing ha_mcp_tools. This suggests Home Assistant isn't even attempting to auto-install the requirement.
📋 AI-Generated Content / Logs / Config
🖥️ Client Application
Claude Desktop
📦 Installation Method
Other (specify below)
💻 Operating System
Other
OS Version
HA OS
📖 Setup Guide Followed
https://homeassistant-ai.github.io/ha-mcp/setup/?method=ha-component&client=claude-code&scope=remote&remote=builtin-webhook
🔄 Exact Steps You Followed
installed ha_mcp_tools via HACS (custom repository homeassistant-ai/ha-mcp-integration)
Restarted Home Assistant
Went to Settings → Devices & Services → Add Integration → "HA-MCP Custom Component" → chose entry type "HA-MCP Server"
The error above appeared immediately during config entry setup
Performed a full restart (Settings → System → Restart) — error persisted
Searched the Core log after the restart — found no requirements-installation lines for ha_mcp_tools
🐍 Python Version
No response
📦 ha-mcp Version
latest
🏠 Home Assistant Version
2026.9.0b0
💡 Additional Context
Note: running Home Assistant Core 2026.9.0b0 (beta) — happy to test on stable if that helps narrow it down.
I know it is beta, just as a heads up