MCP Home Assistant

# Changelog All notable changes to this project will be documented in this file. ## [2.2.0] - 2025-11-09 ### 🚀 MAJOR: Complete HACS Integration with WebSocket **Full HACS Management** - Browse, search, and install 1000+ integrations via Cursor AI! ### New MCP Tools Added 7 HACS tools (4 new, 3 enhanced): **Installation:** - `ha_install_hacs` - Install HACS automatically - `ha_hacs_status` - Check if HACS is installed **Repository Management (NEW - WebSocket powered):** - `ha_hacs_list_repositories` - List all HACS repositories ✨ Enhanced - `ha_hacs_search` - Search by name/author/description ✨ NEW - `ha_hacs_install_repository` - Install from HACS ✨ Enhanced - `ha_hacs_update_all` - Update all repositories ✨ NEW - `ha_hacs_repository_details` - Get detailed repo info ✨ NEW ### Features **Agent v2.2.0 adds WebSocket:** - Persistent WebSocket connection to Home Assistant - Real-time state access - Service calls via WebSocket - Auto-reconnect with backoff - Background task management **Full workflow now works:** ``` User: "Install HACS and then install Xiaomi Gateway 3" AI: 1. Installs HACS from GitHub ✅ 2. Restarts Home Assistant ✅ 3. Waits for connection ✅ 4. Searches: "xiaomi gateway" ✅ 5. Finds: "AlexxIT/XiaomiGateway3" ✅ 6. Installs via hacs.download ✅ 7. Guides through config ✅ ``` **What you can do:** - 📦 "Install HACS" - 🔍 "Search for Xiaomi integrations in HACS" - ⬇️ "Install Xiaomi Gateway 3 from HACS" - 🔄 "Update all my HACS integrations" - 📊 "Show me details about the Xiaomi Gateway integration" **Requirements:** - HA Cursor Agent v2.2.0+ (with WebSocket) - HACS configured via UI first time (one-time) ## [2.1.0] - 2025-11-09 ### ✨ NEW: HACS Support (Initial) Basic HACS installation support (file operations only). **Note:** v2.1.0 only supported installation. v2.2.0 adds full repository management with WebSocket. ## [2.0.0] - 2025-11-08 ### 🚨 BREAKING CHANGES - **Removed `HA_TOKEN` support** - only `HA_AGENT_KEY` is accepted now - Old configurations with `HA_TOKEN` will **STOP WORKING** - Must update to `HA_AGENT_KEY` in your Cursor MCP configuration - Cleaner API without legacy naming ### Migration Required **If you're using `HA_TOKEN`:** ```json // OLD (will not work in v2.0.0+): { "env": { "HA_TOKEN": "your-key" } } // NEW (required): { "env": { "HA_AGENT_KEY": "your-key" } } ``` **How to migrate:** 1. Update HA Cursor Agent add-on to v2.0.0 2. Get new configuration from Web UI (Settings → Add-ons → HA Cursor Agent → Open Web UI) 3. Copy the ready-to-use JSON config 4. Update Cursor: Settings → Tools & MCP → Edit your server or add new one 5. Restart Cursor ### Why This Change? - ✅ Accurate naming: It's an Agent Key, not a HA Token - ✅ No confusion with Home Assistant authentication tokens - ✅ Simpler codebase - ✅ Clear API semantics ### What Stays the Same - ✅ Same MCP tools and functionality - ✅ Same HA Cursor Agent API endpoints - ✅ Only variable name changed --- ## [1.0.14] - 2025-11-08 ### Documentation - Fixed Ingress Panel access path in documentation ## [1.0.13] - 2025-11-08 ### Documentation - Updated setup instructions to use Cursor Settings UI ## [1.0.12] - 2025-11-08 ### Documentation - Updated agent version requirements ## [1.0.11] - 2025-11-08 ### Documentation - Updated to reference agent v1.0.11+ ## [1.0.10] - 2025-11-08 ### Documentation - Updated to reference agent v1.0.10+ ## [1.0.9] - 2025-11-08 ### Added - Support for `HA_AGENT_KEY` environment variable (with backward compatibility to `HA_TOKEN`) ## [1.0.8] - 2025-11-08 ### Documentation - Updated for API Key authentication instead of Long-Lived Tokens ## [1.0.7] - 2025-11-08 ### Documentation - Updated for HA Cursor Agent v1.0.9+ with API Key system ## [1.0.6] - 2025-11-08 ### Fixed - Fixed `ha_reload_config` to properly pass component parameter ### Added - `ha_git_diff` tool for viewing differences between commits ## [1.0.5] - 2025-11-08 ### Changed - Updated tool descriptions with [READ-ONLY] and [WRITE] labels ## [1.0.4] - 2025-11-08 ### Added - Better log formatting for `ha_get_logs` tool ## [1.0.3] - 2025-11-08 ### Added - Git diff functionality ## [1.0.2] - 2025-11-08 ### Documentation - Updated README with improved instructions ## [1.0.1] - 2025-11-08 ### Fixed - Initial release fixes ## [1.0.0] - 2025-11-08 ### Added - Initial release - MCP server for Home Assistant via HA Cursor Agent - Full API coverage (files, entities, helpers, automations, scripts, system, backup, logs) - TypeScript implementation - NPM package publication