[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72399":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":24,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},72399,"ha-mcp","homeassistant-ai\u002Fha-mcp","homeassistant-ai","The Unofficial and Awesome Home Assistant MCP Server",null,"Python",3323,132,15,6,0,65,148,514,195,28.37,"MIT License",false,"master",true,[],"2026-06-12 02:03:02","> **Breaking change (v7.3.0):** `ha_config_set_yaml` has been moved to [beta](docs\u002Fbeta.md).\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"docs\u002Fimg\u002Fha-mcp-logo.png\" alt=\"Home Assistant MCP Server Logo\" width=\"300\"\u002F>\n\n  # The Unofficial and Awesome Home Assistant MCP Server\n\n  \u003C!-- mcp-name: io.github.homeassistant-ai\u002Fha-mcp -->\n\n  \u003Cp align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftools-88-blue\" alt=\"95+ Tools\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Freleases\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fhomeassistant-ai\u002Fha-mcp\" alt=\"Release\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Factions\u002Fworkflows\u002Fe2e-tests.yml\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fhomeassistant-ai\u002Fha-mcp\u002Fe2e-tests.yml?branch=master&label=E2E%20Tests\" alt=\"E2E Tests\">\u003C\u002Fa>\n    \u003Ca href=\"LICENSE.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fhomeassistant-ai\u002Fha-mcp.svg\" alt=\"License\">\u003C\u002Fa>\n    \u003Cbr>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Fcommits\u002Fmaster\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcommit-activity\u002Fm\u002Fhomeassistant-ai\u002Fha-mcp.svg\" alt=\"Activity\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fjlowin\u002Ffastmcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBuilt%20with-FastMCP-purple\" alt=\"Built with FastMCP\">\u003C\u002Fa>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fpython\u002Frequired-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fhomeassistant-ai%2Fha-mcp%2Fmaster%2Fpyproject.toml\" alt=\"Python Version\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjulienld\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGitHub_Sponsors-☕-blueviolet\" alt=\"GitHub Sponsors\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWebsite-docs-teal\" alt=\"Website\">\u003C\u002Fa>\n  \u003C\u002Fp>\n\n  \u003Cp align=\"center\">\n    \u003Cem>A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.\u003Cbr>\n    Using natural language, control smart home devices, query states, execute services and manage your automations.\u003C\u002Fem>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n---\n\n![Demo with Claude Desktop](docs\u002Fimg\u002Fdemo.webp)\n\n---\n\n## 🚀 Get Started\n\n### Full guide to get you started with Claude Desktop (~10 min)\n\n*No paid subscription required.* Click on your operating system:\n\n\u003Cp>\n\u003Ca href=\"https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002Fguide-macos\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSetup_Guide_for_macOS-000000?style=for-the-badge&logo=apple&logoColor=white\" alt=\"Setup Guide for macOS\" height=\"120\">\u003C\u002Fa>    \u003Ca href=\"https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002Fguide-windows\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSetup_Guide_for_Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white\" alt=\"Setup Guide for Windows\" height=\"120\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n### Quick install (~5 min)\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🍎 macOS\u003C\u002Fb>\u003C\u002Fsummary>\n\n1. Go to [claude.ai](https:\u002F\u002Fclaude.ai) and sign in (or create a free account)\n2. Open **Terminal** and run:\n   ```sh\n   curl -LsSf https:\u002F\u002Fraw.githubusercontent.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Fmaster\u002Fscripts\u002Finstall-macos.sh | sh\n   ```\n3. [Download Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload) (or restart: Claude menu → Quit)\n4. Ask Claude: **\"Can you see my Home Assistant?\"**\n\nYou're now connected to the demo environment! [Connect your own Home Assistant →](https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002Fguide-macos\u002F#step-6-connect-your-home-assistant)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🪟 Windows\u003C\u002Fb>\u003C\u002Fsummary>\n\n1. Go to [claude.ai](https:\u002F\u002Fclaude.ai) and sign in (or create a free account)\n2. Open **Windows PowerShell** (from Start menu) and run:\n   ```powershell\n   irm https:\u002F\u002Fraw.githubusercontent.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Fmaster\u002Fscripts\u002Finstall-windows.ps1 | iex\n   ```\n3. [Download Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload) (or restart: File → Exit)\n4. Ask Claude: **\"Can you see my Home Assistant?\"**\n\nYou're now connected to the demo environment! [Connect your own Home Assistant →](https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002Fguide-windows\u002F#step-6-connect-your-home-assistant)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🏠 Home Assistant OS (Add-on)\u003C\u002Fb>\u003C\u002Fsummary>\n\n1. Add the repository to your Home Assistant instance:\n\n   [![Add Repository](https:\u002F\u002Fmy.home-assistant.io\u002Fbadges\u002Fsupervisor_add_addon_repository.svg)](https:\u002F\u002Fmy.home-assistant.io\u002Fredirect\u002Fsupervisor_add_addon_repository\u002F?repository_url=https%3A%2F%2Fgithub.com%2Fhomeassistant-ai%2Fha-mcp)\n\n2. Install **\"Home Assistant MCP Server\"** from the Add-on Store and wait for it to complete\n3. Click **Start**, then open the **Logs** tab to find your unique MCP URL\n4. Configure your AI client with that URL\n\nNo token or credential setup needed — the add-on connects to Home Assistant automatically.\n\n[Full add-on documentation →](homeassistant-addon\u002FDOCS.md)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🌐 Remote Access (Nabu Casa \u002F Webhook Proxy)\u003C\u002Fb>\u003C\u002Fsummary>\n\nAlready have **Nabu Casa** or another reverse proxy pointing at your Home Assistant? The Webhook Proxy add-on routes MCP traffic through your existing setup — no separate tunnel or port forwarding needed.\n\n1. Install the **MCP Server add-on** (see above) and the **Webhook Proxy** add-on from the same store\n2. Start the webhook proxy and **restart Home Assistant** when prompted\n3. Copy the webhook URL from the add-on logs:\n   ```\n   MCP Server URL (remote): https:\u002F\u002Fxxxxx.ui.nabu.casa\u002Fapi\u002Fwebhook\u002Fmcp_xxxxxxxx\n   ```\n4. Configure your AI client with that URL\n\nFor other remote access methods (Cloudflare Tunnel, custom reverse proxy), see the [Setup Wizard](https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002Fsetup\u002F).\n\n[Webhook proxy documentation →](https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Fblob\u002Fmaster\u002Fhomeassistant-addon-webhook-proxy\u002FDOCS.md)\n\n\u003C\u002Fdetails>\n\n### 🧙 Setup Wizard for 15+ clients\n\n**Claude Code, Gemini CLI, ChatGPT, Open WebUI, VSCode, Cursor, and more.**\n\n\u003Cp>\n\u003Ca href=\"https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002Fsetup\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpen_Setup_Wizard-4A90D9?style=for-the-badge\" alt=\"Open Setup Wizard\" height=\"40\">\u003C\u002Fa>\n\u003C\u002Fp>\n\nHaving issues? Check the **[FAQ & Troubleshooting](https:\u002F\u002Fhomeassistant-ai.github.io\u002Fha-mcp\u002Ffaq\u002F)**\n\n---\n\n## 💬 What Can You Do With It?\n\nJust talk to Claude naturally. Here are some real examples:\n\n| You Say | What Happens |\n|---------|--------------|\n| *\"Create an automation that turns on the porch light at sunset\"* | Creates the automation with proper triggers and actions |\n| *\"Add a weather card to my dashboard\"* | Updates your Lovelace dashboard with the new card |\n| *\"The motion sensor automation isn't working, debug it\"* | Analyzes execution traces, identifies the issue, suggests fixes |\n| *\"Make my morning routine automation also turn on the coffee maker\"* | Reads the existing automation, adds the new action, updates it |\n| *\"Create a script that sets movie mode: dim lights, close blinds, turn on TV\"* | Creates a reusable script with the sequence of actions |\n\nSpend less time configuring, more time enjoying your smart home.\n\n---\n\n## ✨ Features\n\n| Category | Capabilities |\n|----------|--------------|\n| **🔍 Search** | Fuzzy entity search, deep config search, system overview |\n| **🏠 Control** | Any service, bulk device control, real-time states |\n| **🔧 Manage** | Automations, scripts, helpers, dashboards, areas, zones, groups, calendars, blueprints |\n| **📊 Monitor** | History, statistics, camera snapshots, automation traces, ZHA devices |\n| **💾 System** | Backup\u002Frestore, updates, add-ons, device registry |\n\n\u003Cdetails>\n\u003C!-- TOOLS_TABLE_START -->\n\n\u003Csummary>\u003Cb>Complete Tool List (88 tools)\u003C\u002Fb>\u003C\u002Fsummary>\n\n| Category | Tools |\n|----------|-------|\n| **Add-ons** | `ha_get_addon`, `ha_manage_addon` |\n| **Areas & Floors** | `ha_config_list_areas`, `ha_config_list_floors`, `ha_list_floors_areas`, `ha_remove_area_or_floor`, `ha_set_area_or_floor` |\n| **Automations** | `ha_config_get_automation`, `ha_config_remove_automation`, `ha_config_set_automation` |\n| **Blueprints** | `ha_get_blueprint`, `ha_import_blueprint` |\n| **Calendar** | `ha_config_get_calendar_events`, `ha_config_remove_calendar_event`, `ha_config_set_calendar_event` |\n| **Camera** | `ha_get_camera_image` |\n| **Dashboards** | `ha_config_delete_dashboard_resource`, `ha_config_delete_dashboard`, `ha_config_get_dashboard`, `ha_config_list_dashboard_resources`, `ha_config_set_dashboard_resource`, `ha_config_set_dashboard` |\n| **Device Registry** | `ha_get_device`, `ha_remove_device`, `ha_update_device` |\n| **Energy** | `ha_manage_energy_prefs` |\n| **Entity Registry** | `ha_get_entity_exposure`, `ha_get_entity`, `ha_remove_entity`, `ha_set_entity` |\n| **Files** | `ha_delete_file` *(beta)*, `ha_list_files` *(beta)*, `ha_read_file` *(beta)*, `ha_write_file` *(beta)* |\n| **Groups** | `ha_config_list_groups`, `ha_config_remove_group`, `ha_config_set_group` |\n| **HACS** | `ha_hacs_add_repository`, `ha_hacs_download`, `ha_hacs_repository_info`, `ha_hacs_search` |\n| **Helper Entities** | `ha_config_list_helpers`, `ha_config_set_helper`, `ha_delete_helpers_integrations` |\n| **History & Statistics** | `ha_get_automation_traces`, `ha_get_history`, `ha_get_logs` |\n| **Integrations** | `ha_get_integration`, `ha_set_integration_enabled` |\n| **Labels & Categories** | `ha_config_get_category`, `ha_config_get_label`, `ha_config_remove_category`, `ha_config_remove_label`, `ha_config_set_category`, `ha_config_set_label` |\n| **Scenes** | `ha_config_get_scene`, `ha_config_remove_scene`, `ha_config_set_scene` |\n| **Scripts** | `ha_config_get_script`, `ha_config_remove_script`, `ha_config_set_script` |\n| **Search & Discovery** | `ha_deep_search`, `ha_get_overview`, `ha_get_state`, `ha_search_entities` |\n| **Service & Device Control** | `ha_bulk_control`, `ha_call_event`, `ha_call_service`, `ha_get_operation_status`, `ha_list_services` |\n| **System** | `ha_backup_create`, `ha_backup_restore`, `ha_check_config`, `ha_config_set_yaml` *(beta)*, `ha_get_system_health`, `ha_get_updates`, `ha_manage_custom_tool` *(beta)*, `ha_reload_core`, `ha_restart` |\n| **Todo Lists** | `ha_get_todo`, `ha_remove_todo_item`, `ha_set_todo_item` |\n| **Utilities** | `ha_eval_template`, `ha_install_mcp_tools` *(beta)*, `ha_report_issue` |\n| **Zones** | `ha_get_zone`, `ha_remove_zone`, `ha_set_zone` |\n\n\u003C!-- TOOLS_TABLE_END -->\n\u003C\u002Fdetails>\n\n---\n\n## 🔌 Custom Component (ha_mcp_tools) *(beta)*\n\nSome 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.\n\n**Tools that require the component:**\n\n| Tool | Description |\n|------|-------------|\n| `ha_config_set_yaml` *(beta)* | Safely add, replace, or remove top-level YAML keys in `configuration.yaml` and package files (automatic backup, validation, and config check) |\n| `ha_list_files` *(beta)* | List files in allowed directories (www\u002F, themes\u002F, custom_templates\u002F) |\n| `ha_read_file` *(beta)* | Read files from allowed paths (config YAML, logs, www\u002F, themes\u002F, custom_templates\u002F, custom_components\u002F) |\n| `ha_write_file` *(beta)* | Write files to allowed directories |\n| `ha_delete_file` *(beta)* | Delete files from allowed directories |\n\nAll other tools work without the component. These five return an error with installation instructions if the component is missing.\n\nThese 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`.\n\n### Install using HACS (recommended)\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https:\u002F\u002Fmy.home-assistant.io\u002Fbadges\u002Fhacs_repository.svg)](https:\u002F\u002Fmy.home-assistant.io\u002Fredirect\u002Fhacs_repository\u002F?owner=homeassistant-ai&repository=ha-mcp&category=integration)\n\nTo add manually: open **HACS** > **Integrations** > three-dot menu > **Custom repositories** > add `https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fha-mcp` (category: Integration) > **Download**.\n\nAfter installing, restart Home Assistant. Then open **Settings** > **Devices & Services** > **Add Integration** and search for **HA MCP Tools**.\n\n### Install manually\n\nCopy `custom_components\u002Fha_mcp_tools\u002F` from this repository into your HA `config\u002Fcustom_components\u002F` directory. Restart Home Assistant, then add the integration as described above.\n\n---\n\n## 🧠 Better Results with Agent Skills\n\nThis server gives your AI agent tools to control Home Assistant. For better configurations, pair it with [Home Assistant Agent Skills](https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fskills) — domain knowledge that teaches the agent Home Assistant best practices.\n\nAn MCP server can create automations, helpers, and dashboards, but it has no opinion on *how* to structure them. Without domain knowledge, agents tend to over-rely on templates, pick the wrong helper type, or produce automations that are hard to maintain. The skills fill that gap: native constructs over Jinja2 workarounds, correct helper selection, safe refactoring workflows, and proper use of automation modes.\n\n### Bundled Skills (built-in)\n\nSkills from `homeassistant-ai\u002Fskills` are bundled and served as [MCP resources](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Fconcepts\u002Fresources) via `skill:\u002F\u002F` URIs. Any MCP client that supports resources can discover them automatically — no manual installation needed. For tool-only clients (claude.ai, etc.), the same skills are reachable through the polymorphic `ha_get_skill_guide` tool — call it with no args to list bundled skills, with a `skill` arg to list its files, or with `skill` + `file` to read content. Resources are not auto-injected into context — clients must explicitly request them, so idle context cost is just the metadata listing.\n\n`ha_get_skill_guide` is mandatory-pinned: the catalog always exposes it so tool-only clients never see a silently missing skill surface.\n\nSkills can still be installed manually for clients that prefer local skill files — see the [skills repo](https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fskills) for instructions.\n\n---\n\n## 🔍 Tool Discovery for AI Agents\n\nBy default, the full tool catalog (~86 tools) is listed to the client through the standard MCP `tools\u002Flist` response. Clients with deferred \u002F on-demand tool loading (Claude Sonnet, Claude Opus,) handle that fine — tools are pulled into context only when needed, so idle context cost is near-zero.\n\nFor models *without* deferred tool support — Claude Haiku, Gemini, ChatGPT OpenAI-compatible local models, smaller open-weights models — listing 86 tools eats ~46K tokens of idle context. To address that, the server ships with a **search-based discovery mode** built on top of FastMCP's BM25 search transform.\n\n### Enable search-based discovery\n\nSet ENABLE_TOOL_SEARCH=true (or toggle the option in the HA add-on). The full catalog is replaced in the tool list with four entry points plus a small set of always-visible \"pinned\" tools (ha_search_entities, ha_get_overview, ha_restart, etc.). All tools remain callable directly by name once discovered:\n\n| Tool | Purpose |\n|------|---------|\n| `ha_search_tools` | BM25 keyword search across all tools. Returns name, description, parameters, and annotations (`readOnlyHint` \u002F `destructiveHint`) so the agent can pick the right one. |\n| `ha_call_read_tool` | Execute a `readOnlyHint` tool by name. Safe — clients can auto-approve. |\n| `ha_call_write_tool` | Execute a write tool that creates or updates data. |\n| `ha_call_delete_tool` | Execute a tool that removes \u002F deletes data. |\n\nThe proxy split lets MCP clients apply different permission policies per category (e.g. auto-approve reads, prompt for writes, confirm deletes) without parsing tool docstrings.\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `ENABLE_TOOL_SEARCH` | `false` | Replace full tool catalog with search-based discovery (~46K → ~5K idle tokens). |\n| `TOOL_SEARCH_MAX_RESULTS` | `5` | Max results returned by `ha_search_tools` (range 2–10). |\n| `PINNED_TOOLS` | empty | Comma-separated tool names to keep always visible. The web settings UI is the primary way to manage this. |\n\n### When to enable\n\n- **Claude Haiku, OpenAI-compatible local models, Gemini, ChatGPT or any model without native deferred tool support** — large idle-context savings.\n- MCP clients that cap total tool count (some cap at 100) — surfaces a minimal set (~10 tools) instead of 86.\n- **Cost-sensitive deployments** — fewer idle tokens per turn.\n\nLeave it off when using Claude Sonnet\u002FOpus or any client with deferred tool loading; the full catalog has no idle cost there and direct calls skip the search step. If you choose to use our toolsearch then you should disable the native Claude Opus\u002FSonnet toolsearch, which is called deferred tools in the settings.\n\nFor the HA add-on, the same option is documented in [`homeassistant-addon\u002FDOCS.md`](homeassistant-addon\u002FDOCS.md#enable_tool_search) along with the in-add-on settings UI for fine-grained tool enable\u002Fdisable\u002Fpin.\n\n---\n\n## 🧪 Dev Channel\n\nWant early access to new features and fixes? Dev releases (`.devN`) are published on every push to master.\n\n**[Dev Channel Documentation](docs\u002Fdev-channel.md)** — Instructions for pip\u002Fuvx, Docker, and Home Assistant add-on.\n\n---\n\n## 🤝 Contributing\n\nFor development setup, testing instructions, and contribution guidelines, see **[CONTRIBUTING.md](CONTRIBUTING.md)**.\n\nFor comprehensive testing documentation, see **[tests\u002FREADME.md](tests\u002FREADME.md)**.\n\n---\n\n## 🔒 Privacy\n\nHa-mcp runs **locally** on your machine. Your smart home data stays on your network.\n\n- **Configurable telemetry** — optional anonymous usage stats\n- **No personal data collection** — we never collect entity names, configs, or device data\n- **User-controlled bug reports** — only sent with your explicit approval\n\nFor full details, see our [Privacy Policy](PRIVACY.md).\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- **[Home Assistant](https:\u002F\u002Fhome-assistant.io\u002F)**: Amazing smart home platform (!)\n- **[FastMCP](https:\u002F\u002Fgithub.com\u002Fjlowin\u002Ffastmcp)**: Excellent MCP server framework\n- **[Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io\u002F)**: Standardized AI-application communication\n- **[Claude Code](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code)**: AI-powered coding assistant\n\n## 👥 Contributors\n\n### Maintainers\n\n- **[@julienld](https:\u002F\u002Fgithub.com\u002Fjulienld)** — Project creator.\n- **[@sergeykad](https:\u002F\u002Fgithub.com\u002Fsergeykad)** — Core maintainer.\n- **[@kingpanther13](https:\u002F\u002Fgithub.com\u002Fkingpanther13)** — Core maintainer.\n\n### Contributors\n\n- **[@bigeric08](https:\u002F\u002Fgithub.com\u002Fbigeric08)** — Explicit `mcp` dependency for protocol version 2025-11-25 support.\n- **[@airlabno](https:\u002F\u002Fgithub.com\u002Fairlabno)** — Support for `data` field in schedule time blocks.\n- **[@ryphez](https:\u002F\u002Fgithub.com\u002Fryphez)** — Codex Desktop UI MCP quick setup guide.\n- **[@Danm72](https:\u002F\u002Fgithub.com\u002FDanm72)** — Entity registry tools (`ha_set_entity`, `ha_get_entity`) for managing entity properties.\n- **[@Raygooo](https:\u002F\u002Fgithub.com\u002FRaygooo)** — SOCKS proxy support.\n- **[@cj-elevate](https:\u002F\u002Fgithub.com\u002Fcj-elevate)** — Integration & entity management tools (enable\u002Fdisable\u002Fdelete); person\u002Fzone\u002Ftag config store routing.\n- **[@maxperron](https:\u002F\u002Fgithub.com\u002Fmaxperron)** — Beta testing.\n- **[@kingbear2](https:\u002F\u002Fgithub.com\u002Fkingbear2)** — Windows UV setup guide.\n- **[@konradwalsh](https:\u002F\u002Fgithub.com\u002Fkonradwalsh)** — Financial support via [GitHub Sponsors](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjulienld). Thank you! ☕\n- **[@knowald](https:\u002F\u002Fgithub.com\u002Fknowald)** — Area resolution via device registry in `ha_get_system_overview` for entities assigned through their parent device. Financial support via [GitHub Sponsors](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjulienld). Thank you! ☕\n- **[@zorrobyte](https:\u002F\u002Fgithub.com\u002Fzorrobyte)** — Per-client WebSocket credentials in OAuth mode, fixing WebSocket tool failures.\n- **[@deanbenson](https:\u002F\u002Fgithub.com\u002Fdeanbenson)** — Fixed `ha_deep_search` timeout on large Home Assistant instances with many automations.\n- **[@saphid](https:\u002F\u002Fgithub.com\u002Fsaphid)** — Config entry options flow tools (initial design, #590).\n- **[@adraguidev](https:\u002F\u002Fgithub.com\u002Fadraguidev)** — Fix menu-based config entry flows for group helpers (#647).\n- **[@transportrefer](https:\u002F\u002Fgithub.com\u002Ftransportrefer)** — Integration options inspection (`ha_get_integration` schema support, #689).\n- **[@teh-hippo](https:\u002F\u002Fgithub.com\u002Fteh-hippo)** — Fix blueprint import missing save step.\n- **[@smenzer](https:\u002F\u002Fgithub.com\u002Fsmenzer)** — Documentation fix.\n- **[@The-Greg-O](https:\u002F\u002Fgithub.com\u002FThe-Greg-O)** — REST API for config entry deletion.\n- **[@restriction](https:\u002F\u002Fgithub.com\u002Frestriction)** — Responsible disclosure: python_transform sandbox missing call target validation.\n- **[@lcrostarosa](https:\u002F\u002Fgithub.com\u002Flcrostarosa)** — Diagnostic and health monitoring tools concept (#675), inspiring system\u002Ferror logs, repairs, and ZHA radio metrics integration.\n- **[@roysha1](https:\u002F\u002Fgithub.com\u002Froysha1)** — Copilot CLI support in the installation wizard; replaced placeholder logo SVGs with real brand icons on the documentation site.\n- **[@Patch76](https:\u002F\u002Fgithub.com\u002FPatch76)** — `ha_remove_entity` tool, history\u002Fstatistics pagination and validation, docs sync automation, docstring guidelines, dashboard tool consolidation.\n- **[@teancom](https:\u002F\u002Fgithub.com\u002Fteancom)** — Fix add-on stats endpoint (`\u002Faddons\u002F{slug}\u002Fstats`).\n- **[@TomasDJo](https:\u002F\u002Fgithub.com\u002FTomasDJo)** — Category support for automations, scripts, and scenes.\n- **[@bzelch](https:\u002F\u002Fgithub.com\u002Fbzelch)** — `python_transform` support for automations and scripts.\n- **[@gcormier](https:\u002F\u002Fgithub.com\u002Fgcormier)** — Windows installer improvements: removed unused variable and fixed terminal closing after install.\n- **[@ekobres](https:\u002F\u002Fgithub.com\u002Fekobres)** — Feature flags for `HAMCP_ENABLE_FILESYSTEM_TOOLS` and `HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION` in the add-on config, with beta tagging in source and docs.\n- **[@w3z315](https:\u002F\u002Fgithub.com\u002Fw3z315)** — Financial support via [GitHub Sponsors](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjulienld). Thank you! ☕\n- **[@griffinmartin](https:\u002F\u002Fgithub.com\u002Fgriffinmartin)** — Added OpenCode (by Anomaly) as a selectable AI client in the setup wizard, with both stdio and streamable HTTP support.\n- **[@hhopke](https:\u002F\u002Fgithub.com\u002Fhhopke)** — Fixed addon API calls to route through HA Core ingress proxy instead of direct container connections, fixing `ha_manage_addon` proxy mode on addon installs.\n\n---\n\n## 💬 Community\n\n- **[GitHub Discussions](https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Fdiscussions)** — Ask questions, share ideas\n- **[Issue Tracker](https:\u002F\u002Fgithub.com\u002Fhomeassistant-ai\u002Fha-mcp\u002Fissues)** — Report bugs, request features, or suggest tool behavior improvements\n\n---\n\n## ⭐ Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=homeassistant-ai\u002Fha-mcp&type=Date)](https:\u002F\u002Fstar-history.com\u002F#homeassistant-ai\u002Fha-mcp&Date)\n","该项目是一个非官方的、功能强大的Home Assistant MCP服务器，允许AI助手通过自然语言与Home Assistant进行交互。它支持控制智能家居设备、查询状态、执行服务和管理自动化等核心功能，并且基于Python构建，具备95+工具集成能力。特别适合需要增强家庭自动化系统智能化水平的用户，无论是希望通过语音命令简化日常操作还是寻求更高效的家庭管理解决方案，都能从中受益。此外，项目维护活跃，拥有详细的文档和快速入门指南，便于新用户上手使用。",2,"2026-06-11 03:41:53","high_star"]