ha-mcp-dev 7.2.0.dev323__tar.gz → 7.2.0.dev324__tar.gz

{ha_mcp_dev-7.2.0.dev323/src/ha_mcp_dev.egg-info → ha_mcp_dev-7.2.0.dev324}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.2.0.dev323
+Version: 7.2.0.dev324
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT
@@ -193,6 +193,38 @@ Spend less time configuring, more time enjoying your smart home.
 
 ---
 
+## 🔌 Custom Component (ha_mcp_tools)
+
+Some tools require a companion custom component installed in Home Assistant. Standard HA APIs do not expose file system access or YAML config editing. This component provides both.
+
+**Tools that require the component:**
+
+| Tool | Description |
+|------|-------------|
+| `ha_config_set_yaml` | Safely add, replace, or remove top-level YAML keys in `configuration.yaml` and package files (automatic backup, validation, and config check) |
+| `ha_list_files` | List files in allowed directories (www/, themes/, custom_templates/) |
+| `ha_read_file` | Read files from allowed paths (config YAML, logs, www/, themes/, custom_templates/, custom_components/) |
+| `ha_write_file` | Write files to allowed directories |
+| `ha_delete_file` | Delete files from allowed directories |
+
+All other tools work without the component. These five return an error with installation instructions if the component is missing.
+
+These tools also require feature flags: `HAMCP_ENABLE_FILESYSTEM_TOOLS=true` (file tools) and `ENABLE_YAML_CONFIG_EDITING=true` (YAML editing). To enable the `ha_install_mcp_tools` installer tool, set `HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION=true`.
+
+### Install using HACS (recommended)
+
+[![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` (category: Integration) > **Download**.
+
+After installing, restart Home Assistant. Then open **Settings** > **Devices & Services** > **Add Integration** and search for **HA MCP Tools**.
+
+### Install manually
+
+Copy `custom_components/ha_mcp_tools/` from this repository into your HA `config/custom_components/` directory. Restart Home Assistant, then add the integration as described above.
+
+---
+
 ## 🧠 Better Results with Agent Skills
 
 This server gives your AI agent tools to control Home Assistant. For better configurations, pair it with [Home Assistant Agent Skills](https://github.com/homeassistant-ai/skills) — domain knowledge that teaches the agent Home Assistant best practices.

{ha_mcp_dev-7.2.0.dev323 → ha_mcp_dev-7.2.0.dev324}/README.md

@@ -164,6 +164,38 @@ Spend less time configuring, more time enjoying your smart home.
 
 ---
 
+## 🔌 Custom Component (ha_mcp_tools)
+
+Some tools require a companion custom component installed in Home Assistant. Standard HA APIs do not expose file system access or YAML config editing. This component provides both.
+
+**Tools that require the component:**
+
+| Tool | Description |
+|------|-------------|
+| `ha_config_set_yaml` | Safely add, replace, or remove top-level YAML keys in `configuration.yaml` and package files (automatic backup, validation, and config check) |
+| `ha_list_files` | List files in allowed directories (www/, themes/, custom_templates/) |
+| `ha_read_file` | Read files from allowed paths (config YAML, logs, www/, themes/, custom_templates/, custom_components/) |
+| `ha_write_file` | Write files to allowed directories |
+| `ha_delete_file` | Delete files from allowed directories |
+
+All other tools work without the component. These five return an error with installation instructions if the component is missing.
+
+These tools also require feature flags: `HAMCP_ENABLE_FILESYSTEM_TOOLS=true` (file tools) and `ENABLE_YAML_CONFIG_EDITING=true` (YAML editing). To enable the `ha_install_mcp_tools` installer tool, set `HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION=true`.
+
+### Install using HACS (recommended)
+
+[![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` (category: Integration) > **Download**.
+
+After installing, restart Home Assistant. Then open **Settings** > **Devices & Services** > **Add Integration** and search for **HA MCP Tools**.
+
+### Install manually
+
+Copy `custom_components/ha_mcp_tools/` from this repository into your HA `config/custom_components/` directory. Restart Home Assistant, then add the integration as described above.
+
+---
+
 ## 🧠 Better Results with Agent Skills
 
 This server gives your AI agent tools to control Home Assistant. For better configurations, pair it with [Home Assistant Agent Skills](https://github.com/homeassistant-ai/skills) — domain knowledge that teaches the agent Home Assistant best practices.

{ha_mcp_dev-7.2.0.dev323 → ha_mcp_dev-7.2.0.dev324}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ha-mcp-dev"
-version = "7.2.0.dev323"
+version = "7.2.0.dev324"
 description = "Home Assistant MCP Server - Complete control of Home Assistant through MCP"
 readme = "README.md"
 requires-python = ">=3.13,<3.14"

{ha_mcp_dev-7.2.0.dev323 → ha_mcp_dev-7.2.0.dev324}/src/ha_mcp/tools/tools_mcp_component.py

@@ -5,7 +5,7 @@ This module provides the ha_install_mcp_tools tool which installs the
 ha_mcp_tools custom component via HACS. This enables additional services
 that are not available through standard Home Assistant APIs.
 
-Feature Flag: Set HAMCP_ENABLE_MCP_TOOLS_INSTALLER=true to enable this tool.
+Feature Flag: Set HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION=true to enable this tool.
 """
 
 import logging
@@ -32,8 +32,7 @@ def is_custom_component_integration_enabled() -> bool:
 
 
 # Constants for ha_mcp_tools custom component
-# TODO: Switch to "homeassistant-ai/ha-mcp" after hacs.json is on default branch
-MCP_TOOLS_REPO = "julienld/ha-mcp-test-custom-component"
+MCP_TOOLS_REPO = "homeassistant-ai/ha-mcp"
 MCP_TOOLS_DOMAIN = "ha_mcp_tools"
 
 

{ha_mcp_dev-7.2.0.dev323 → ha_mcp_dev-7.2.0.dev324/src/ha_mcp_dev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ha-mcp-dev
-Version: 7.2.0.dev323
+Version: 7.2.0.dev324
 Summary: Home Assistant MCP Server - Complete control of Home Assistant through MCP
 Author-email: Julien <github@qc-h.net>
 License: MIT
@@ -193,6 +193,38 @@ Spend less time configuring, more time enjoying your smart home.
 
 ---
 
+## 🔌 Custom Component (ha_mcp_tools)
+
+Some tools require a companion custom component installed in Home Assistant. Standard HA APIs do not expose file system access or YAML config editing. This component provides both.
+
+**Tools that require the component:**
+
+| Tool | Description |
+|------|-------------|
+| `ha_config_set_yaml` | Safely add, replace, or remove top-level YAML keys in `configuration.yaml` and package files (automatic backup, validation, and config check) |
+| `ha_list_files` | List files in allowed directories (www/, themes/, custom_templates/) |
+| `ha_read_file` | Read files from allowed paths (config YAML, logs, www/, themes/, custom_templates/, custom_components/) |
+| `ha_write_file` | Write files to allowed directories |
+| `ha_delete_file` | Delete files from allowed directories |
+
+All other tools work without the component. These five return an error with installation instructions if the component is missing.
+
+These tools also require feature flags: `HAMCP_ENABLE_FILESYSTEM_TOOLS=true` (file tools) and `ENABLE_YAML_CONFIG_EDITING=true` (YAML editing). To enable the `ha_install_mcp_tools` installer tool, set `HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION=true`.
+
+### Install using HACS (recommended)
+
+[![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` (category: Integration) > **Download**.
+
+After installing, restart Home Assistant. Then open **Settings** > **Devices & Services** > **Add Integration** and search for **HA MCP Tools**.
+
+### Install manually
+
+Copy `custom_components/ha_mcp_tools/` from this repository into your HA `config/custom_components/` directory. Restart Home Assistant, then add the integration as described above.
+
+---
+
 ## 🧠 Better Results with Agent Skills
 
 This server gives your AI agent tools to control Home Assistant. For better configurations, pair it with [Home Assistant Agent Skills](https://github.com/homeassistant-ai/skills) — domain knowledge that teaches the agent Home Assistant best practices.