ha-mcp-dev 9.0.0.dev3132__tar.gz → 9.0.0.dev3139__tar.gz

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 9.0.0.dev3132
+Version: 9.0.0.dev3139
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Keywords: mcp,home-assistant,ai,automation,smart-home
 Author: Julien
@@ -98,11 +98,14 @@ The recommended way to run ha-mcp is the **HA-MCP Custom Component**. It install
 
 **Add it to Home Assistant via HACS (the preferred install):**
 
-[![Add HA-MCP to HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp-integration&category=integration)
+[![Add HA-MCP to HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp&category=integration)
 
 **Quick start:**
 
-1. Install the **HA-MCP Custom Component** from HACS — click the badge above, or in HACS open **Integrations → ⋮ → Custom repositories**, add `https://github.com/homeassistant-ai/ha-mcp-integration` (category: **Integration**), then **Download**.
+> The setup below is for version 9.0.0 (October 28, 2026) and later; earlier versions show a shorter setup form without the administrator account step.
+
+1. Install the **HA-MCP Custom Component** from HACS — click the badge above, or in HACS open **Integrations → ⋮ → Custom repositories**, add `https://github.com/homeassistant-ai/ha-mcp` (category: **Integration**), then **Download**.
+   Already installed from the earlier `homeassistant-ai/ha-mcp-integration` repository? It keeps receiving the same releases; nothing to change.
 2. **Restart Home Assistant.**
 3. Decide which administrator account the server acts as. Either create a long-lived access token on your own account (your profile → **Security** → **Long-lived access tokens** → **Create token**; it works from anywhere if it leaks, and the server's changes show under your name), or, safer, create an account just for HA-MCP under **Settings → People → Add person** with **Allow login**, **Local access only** and **Administrator** on. Never use your own login for the second option.
 4. Go to **Settings → Devices & Services → Add Integration**, search for **HA-MCP Custom Component** and choose **HA-MCP Server**. Paste your token, or enter the user name and password of the account you made for HA-MCP (HA-MCP creates its token), pick how clients may connect — **Remote access through Home Assistant** (start with **Secret URL**, the simplest; **Home Assistant sign-in** adds a login) and/or **Network access: Local network** — then click **Submit**. Both start disabled, so a client on another device needs one of them.
@@ -369,9 +372,9 @@ These tools also require beta feature flags. See **[Beta Features](docs/beta.md)
 
 Install the **HA-MCP File & YAML Tools** entry from the same **HA-MCP Custom Component**:
 
-[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp-integration&category=integration)
+[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp&category=integration)
 
-To add manually: open **HACS** > **Integrations** > three-dot menu > **Custom repositories** > add `https://github.com/homeassistant-ai/ha-mcp-integration` (category: Integration) > **Download**. Or copy `custom_components/ha_mcp_tools/` from this repository into your HA `config/custom_components/` directory.
+To add manually: open **HACS** > **Integrations** > three-dot menu > **Custom repositories** > add `https://github.com/homeassistant-ai/ha-mcp` (category: Integration) > **Download**. Or copy `custom_components/ha_mcp_tools/` from this repository into your HA `config/custom_components/` directory.
 
 After installing, restart Home Assistant, then open **Settings** > **Devices & Services** > **Add Integration**, search for **HA-MCP Custom Component**, and add the **HA-MCP File & YAML Tools** entry.
 

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/README.md

@@ -38,11 +38,14 @@ The recommended way to run ha-mcp is the **HA-MCP Custom Component**. It install
 
 **Add it to Home Assistant via HACS (the preferred install):**
 
-[![Add HA-MCP to HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp-integration&category=integration)
+[![Add HA-MCP to HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp&category=integration)
 
 **Quick start:**
 
-1. Install the **HA-MCP Custom Component** from HACS — click the badge above, or in HACS open **Integrations → ⋮ → Custom repositories**, add `https://github.com/homeassistant-ai/ha-mcp-integration` (category: **Integration**), then **Download**.
+> The setup below is for version 9.0.0 (October 28, 2026) and later; earlier versions show a shorter setup form without the administrator account step.
+
+1. Install the **HA-MCP Custom Component** from HACS — click the badge above, or in HACS open **Integrations → ⋮ → Custom repositories**, add `https://github.com/homeassistant-ai/ha-mcp` (category: **Integration**), then **Download**.
+   Already installed from the earlier `homeassistant-ai/ha-mcp-integration` repository? It keeps receiving the same releases; nothing to change.
 2. **Restart Home Assistant.**
 3. Decide which administrator account the server acts as. Either create a long-lived access token on your own account (your profile → **Security** → **Long-lived access tokens** → **Create token**; it works from anywhere if it leaks, and the server's changes show under your name), or, safer, create an account just for HA-MCP under **Settings → People → Add person** with **Allow login**, **Local access only** and **Administrator** on. Never use your own login for the second option.
 4. Go to **Settings → Devices & Services → Add Integration**, search for **HA-MCP Custom Component** and choose **HA-MCP Server**. Paste your token, or enter the user name and password of the account you made for HA-MCP (HA-MCP creates its token), pick how clients may connect — **Remote access through Home Assistant** (start with **Secret URL**, the simplest; **Home Assistant sign-in** adds a login) and/or **Network access: Local network** — then click **Submit**. Both start disabled, so a client on another device needs one of them.
@@ -309,9 +312,9 @@ These tools also require beta feature flags. See **[Beta Features](docs/beta.md)
 
 Install the **HA-MCP File & YAML Tools** entry from the same **HA-MCP Custom Component**:
 
-[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp-integration&category=integration)
+[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=homeassistant-ai&repository=ha-mcp&category=integration)
 
-To add manually: open **HACS** > **Integrations** > three-dot menu > **Custom repositories** > add `https://github.com/homeassistant-ai/ha-mcp-integration` (category: Integration) > **Download**. Or copy `custom_components/ha_mcp_tools/` from this repository into your HA `config/custom_components/` directory.
+To add manually: open **HACS** > **Integrations** > three-dot menu > **Custom repositories** > add `https://github.com/homeassistant-ai/ha-mcp` (category: Integration) > **Download**. Or copy `custom_components/ha_mcp_tools/` from this repository into your HA `config/custom_components/` directory.
 
 After installing, restart Home Assistant, then open **Settings** > **Devices & Services** > **Add Integration**, search for **HA-MCP Custom Component**, and add the **HA-MCP File & YAML Tools** entry.
 

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.0.0.dev3132"
+version = "9.0.0.dev3139"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ha-mcp-dev"
-version = "9.0.0.dev3132"
+version = "9.0.0.dev3139"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 # Upper bound widened to <3.15 so the package installs on Home Assistant's

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/src/ha_mcp/hacs_auto_refresh.py

@@ -42,8 +42,9 @@ from .utils.data_paths import get_data_dir
 
 logger = logging.getLogger(__name__)
 
-# The repository full_names HACS may track the ha_mcp_tools component under —
-# the dedicated mirror first, the legacy main-repo path second.
+# The repository full_names HACS may track the ha_mcp_tools component under:
+# the main repository (the documented one) and the mirror that earlier installs
+# came from, which keeps receiving the same releases.
 CANDIDATE_REPO_FULL_NAMES = (
     "homeassistant-ai/ha-mcp-integration",
     "homeassistant-ai/ha-mcp",

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/src/ha_mcp/settings_ui/locales/en.json

@@ -331,9 +331,10 @@
     "filesystem.custom.save": "Save paths",
     "filesystem.custom.saved_rejected": "Saved. Rejected (blocked or invalid): {paths}",
     "oauth_callbacks.title": "Allowed OAuth callback URLs",
-    "oauth_callbacks.help": "While Authentication mode is the secret webhook URL, a client that signs in with OAuth is sent back only to a callback URL on this list; any other callback is refused with a page explaining how to add it. Enter one URL per line, exactly as the client sends it. An <code>http://</code> loopback callback (127.0.0.1, [::1] or localhost) also matches on any port. Clients that connect with the webhook URL alone need no entry. Changes apply to the next sign-in, without a restart.",
+    "oauth_callbacks.help": "While Authentication mode is the secret webhook URL, a client that signs in with OAuth is sent back only to a callback URL on this list; any other callback is refused with a page explaining how to add it. Enter one URL per line, exactly as the client sends it. An <code>http://</code> loopback callback (127.0.0.1, [::1] or localhost) also matches on any port. Clients that connect without an OAuth sign-in need no entry. Changes apply to the next sign-in, without a restart.",
     "oauth_callbacks.default": "Default list: {urls}",
     "oauth_callbacks.inactive": "Not in use right now: the list applies only while remote access is on and Authentication mode is the secret webhook URL.",
+    "oauth_callbacks.allow_any": "Turned off: Allow any OAuth callback URL is on in Configure, so any https:// or loopback callback is accepted and this list is not used.",
     "oauth_callbacks.save": "Save callbacks",
     "oauth_callbacks.reset": "Restore default",
     "oauth_callbacks.invalid": "Not saved. These are not usable callback URLs: {urls}. Use https://, or http:// on 127.0.0.1, [::1] or localhost, without a user name, password or #fragment.",

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/src/ha_mcp/settings_ui/settings_js/10_oauth_callbacks.js

@@ -47,12 +47,15 @@ function renderOAuthCallbacks() {
   const defaults = (d.default_allowlist || []).map(u => `<code>${escapeHtml(u)}</code>`).join(', ');
   info.innerHTML =
     `<div class="feature-name" id="label-oauth-callbacks">${escapeHtml(t('oauth_callbacks.title', {}, 'Allowed OAuth callback URLs'))}</div>` +
-    `<div class="feature-help">${tHtml('oauth_callbacks.help', {}, 'While Authentication mode is the secret webhook URL, a client that signs in with OAuth is sent back only to a callback URL on this list; any other callback is refused with a page explaining how to add it. Enter one URL per line, exactly as the client sends it. An <code>http://</code> loopback callback (127.0.0.1, [::1] or localhost) also matches on any port. Clients that connect with the webhook URL alone need no entry. Changes apply to the next sign-in, without a restart.')}</div>` +
+    `<div class="feature-help">${tHtml('oauth_callbacks.help', {}, 'While Authentication mode is the secret webhook URL, a client that signs in with OAuth is sent back only to a callback URL on this list; any other callback is refused with a page explaining how to add it. Enter one URL per line, exactly as the client sends it. An <code>http://</code> loopback callback (127.0.0.1, [::1] or localhost) also matches on any port. Clients that connect without an OAuth sign-in need no entry. Changes apply to the next sign-in, without a restart.')}</div>` +
     (defaults
       ? `<div class="feature-help">${tHtml('oauth_callbacks.default', {urls: defaults}, 'Default list: {urls}')}</div>`
       : '') +
     (d.available && !d.applies
       ? `<div class="feature-locked-note">${escapeHtml(t('oauth_callbacks.inactive', {}, 'Not in use right now: the list applies only while remote access is on and Authentication mode is the secret webhook URL.'))}</div>`
+      : '') +
+    (d.available && d.applies && d.allow_any
+      ? `<div class="feature-locked-note">${escapeHtml(t('oauth_callbacks.allow_any', {}, 'Turned off: Allow any OAuth callback URL is on in Configure, so any https:// or loopback callback is accepted and this list is not used.'))}</div>`
       : '');
 
   const control = document.createElement('div');

{ha_mcp_dev-9.0.0.dev3132 → ha_mcp_dev-9.0.0.dev3139}/src/ha_mcp/tools/tools_filesystem.py

@@ -211,10 +211,10 @@ def _raise_tools_entry_not_set_up() -> NoReturn:
                 + "this ha-mcp server does not need)",
                 "If the HA-MCP integration is not listed there, install it "
                 + 'first: ha_manage_hacs(action="add_repository", '
-                + 'repository="homeassistant-ai/ha-mcp-integration", '
+                + 'repository="homeassistant-ai/ha-mcp", '
                 + 'category="integration"), then ha_manage_hacs('
                 + 'action="download", '
-                + 'repository_id="homeassistant-ai/ha-mcp-integration"), '
+                + 'repository_id="homeassistant-ai/ha-mcp"), '
                 + "then restart Home Assistant (ha_restart)",
                 "Then retry the operation",
             ],