# home-assistant-vibecode-agent — MCP Agent for Home Assistant > Home Assistant Vibecode Agent exposes automations, dashboards, configs and HACS via MCP for AI IDEs. Verified 548★; pushed 2026-05-14. ## Install Merge the JSON below into your `.mcp.json`: ## Quick Use ```bash git clone https://github.com/Coolver/home-assistant-vibecode-agent.git cd home-assistant-vibecode-agent cp .env.example .env # Edit .env with HA_URL / HA_TOKEN / HA_CONFIG_PATH docker compose -f docker-compose.standalone.yml up -d docker compose -f docker-compose.standalone.yml logs | grep "API Key" # Configure your IDE MCP client to connect to http://:8099 (per README) ``` ## Intro Home Assistant Vibecode Agent exposes automations, dashboards, configs and HACS via MCP for AI IDEs. Verified 548★; pushed 2026-05-14. **Best for:** Home Assistant power users who want an AI IDE to create/debug automations and dashboards via MCP **Works with:** Home Assistant OS/Supervised (add-on) or HA Container (standalone Docker); connects to MCP-enabled IDEs (per README) **Setup time:** 15-35 minutes ### Key facts (verified) - GitHub: 548 stars · 46 forks · pushed 2026-05-14. - License: MIT · owner avatar + repo URL verified via GitHub API. - README-backed entrypoint: `docker compose -f docker-compose.standalone.yml up -d`. ## Main - Pick the deployment model that matches your HA install: add-on for OS/Supervised; standalone Docker for HA Container setups. - Use a Long-Lived Access Token and keep it out of chat logs; store it in `.env` and rotate it periodically. - Start by reviewing generated automations and dashboards before deploying; treat AI edits like PRs for your smart home. - If you enable file write access, restrict paths to your HA config directory to avoid accidental destructive edits. ### README (excerpt) **HA Vibecode Agent** [![Version](https://img.shields.io/badge/version-2.10.47-blue.svg)](https://github.com/Coolver/home-assistant-vibecode-agent) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![MCP Package](https://img.shields.io/npm/v/@coolver/home-assistant-mcp?label=MCP%20Package)](https://www.npmjs.com/package/@coolver/home-assistant-mcp) [![Landing Page](https://img.shields.io/badge/Landing%20Page-coolver.github.io-blueviolet)](https://coolver.github.io/home-assistant-vibecode-agent/) **Let AI build your Home Assistant automations – or act as your DevOps for the ones you write by hand. Just describe what you need in natural language. 🏠🤖** You describe your goal → AI inspects your Home Assistant → designs a custom solution → and deploys it on-board automatically. 🚀 And if you prefer to handcraft your automations and scripts yourself, the agent can simply act as your DevOps and extra pair of hands: quickly uploading your changes, running tests, and analyzing logs on demand. **You stay in control and decide how much you delegate to AI and how deep it should go.** Transform the way you manage your smart home. This agent enables **Claude Code**, **Cursor**, **Visual Studio Code (VS Code)**, or any **MCP-enabled IDE** to: - 📝 Analyze your Home Assistant configuration, entities, and devices - 🏗️ Create intelligent automations, scripts, and complete systems — including Home Assistant helpers that can be fully managed programmatically - 🎨 Design and customize UI dashboards with full control over cards, layouts, and styling - 🖌️ Create and tweak themes for a personalized UI - 🔄 Safely deploy changes with automatic Git-based versioning - 🔍 Monitor and troubleshoot your setup through log analysis - 📦 Install and manage HACS integrations and custom repositories No more manual YAML editing or searching through documentation - just describe what you want in natural language! **Real example:** User says *"Install smart climate control"* → AI analyzes 7 TRVs, creates 10 automations + 9 helpers + 10 sensors + 5 scripts, deploys everything, and it just works! https://github.com/user-attachments/assets/0df48019-06c0-48dd-82ad-c7fe0734ddb3 ### Source-backed notes - README documents two install options: a Home Assistant add-on, and a standalone Docker Compose mode. - README standalone mode uses `.env` with `HA_URL`, `HA_TOKEN`, and `HA_CONFIG_PATH`, then starts with `docker compose -f docker-compose.standalone.yml up -d`. - README states an API key is generated on first start and can be found in logs or in a file under the HA config path. ### FAQ - **Which install option should I use?**: Use add-on for HA OS/Supervised; use standalone Docker for HA Container (per README). - **Where do I get the token?**: README instructs creating a Long-Lived Access Token in the HA UI profile page. - **How do I debug connection issues?**: Check container logs for the API key and confirm your IDE points to the host:8099 endpoint. ## Source & Thanks > Created by [Coolver](https://github.com/Coolver). Licensed under MIT. > > [Coolver/home-assistant-vibecode-agent](https://github.com/Coolver/home-assistant-vibecode-agent) — ⭐ 548 Thanks to the upstream maintainers and contributors for publishing this work under an open license. --- ## Quick Use ```bash git clone https://github.com/Coolver/home-assistant-vibecode-agent.git cd home-assistant-vibecode-agent cp .env.example .env # Edit .env with HA_URL / HA_TOKEN / HA_CONFIG_PATH docker compose -f docker-compose.standalone.yml up -d docker compose -f docker-compose.standalone.yml logs | grep "API Key" # Configure your IDE MCP client to connect to http://:8099 (per README) ``` ## Intro Home Assistant Vibecode Agent 通过 MCP 暴露自动化/仪表盘/配置与 HACS 能力，让 Cursor/VS Code 等 AI IDE 直接管理 HA；已验证 548★，更新于 2026-05-14。 **Best for:** 想用 AI IDE 通过 MCP 创建/调试 HA 自动化与仪表盘的 Home Assistant 深度用户 **Works with:** Home Assistant OS/Supervised（Add-on）或 HA Container（独立 Docker）；对接支持 MCP 的 IDE（见 README） **Setup time:** 15-35 minutes ### Key facts (verified) - GitHub：548 stars · 46 forks；最近更新 2026-05-14。 - 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。 - README 中可对照的入口：`docker compose -f docker-compose.standalone.yml up -d`。 ## Main - 按你的 HA 形态选部署：OS/Supervised 用 Add-on；HA Container 用独立 Docker 方案。 - 使用 Long-Lived Access Token，并避免出现在聊天记录里；放到 `.env` 并定期轮换。 - 把 AI 生成/修改的自动化与面板当作 PR：先 review 再部署，避免“自动化风暴”。 - 开启写权限时务必限制路径到 HA 配置目录，避免误改系统文件或删库式操作。 ### README (excerpt) **HA Vibecode Agent** [![Version](https://img.shields.io/badge/version-2.10.47-blue.svg)](https://github.com/Coolver/home-assistant-vibecode-agent) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![MCP Package](https://img.shields.io/npm/v/@coolver/home-assistant-mcp?label=MCP%20Package)](https://www.npmjs.com/package/@coolver/home-assistant-mcp) [![Landing Page](https://img.shields.io/badge/Landing%20Page-coolver.github.io-blueviolet)](https://coolver.github.io/home-assistant-vibecode-agent/) **Let AI build your Home Assistant automations – or act as your DevOps for the ones you write by hand. Just describe what you need in natural language. 🏠🤖** You describe your goal → AI inspects your Home Assistant → designs a custom solution → and deploys it on-board automatically. 🚀 And if you prefer to handcraft your automations and scripts yourself, the agent can simply act as your DevOps and extra pair of hands: quickly uploading your changes, running tests, and analyzing logs on demand. **You stay in control and decide how much you delegate to AI and how deep it should go.** Transform the way you manage your smart home. This agent enables **Claude Code**, **Cursor**, **Visual Studio Code (VS Code)**, or any **MCP-enabled IDE** to: - 📝 Analyze your Home Assistant configuration, entities, and devices - 🏗️ Create intelligent automations, scripts, and complete systems — including Home Assistant helpers that can be fully managed programmatically - 🎨 Design and customize UI dashboards with full control over cards, layouts, and styling - 🖌️ Create and tweak themes for a personalized UI - 🔄 Safely deploy changes with automatic Git-based versioning - 🔍 Monitor and troubleshoot your setup through log analysis - 📦 Install and manage HACS integrations and custom repositories No more manual YAML editing or searching through documentation - just describe what you want in natural language! **Real example:** User says *"Install smart climate control"* → AI analyzes 7 TRVs, creates 10 automations + 9 helpers + 10 sensors + 5 scripts, deploys everything, and it just works! https://github.com/user-attachments/assets/0df48019-06c0-48dd-82ad-c7fe0734ddb3 ### Source-backed notes - README 提供两种安装方式：HA Add-on，以及独立 Docker Compose 模式。 - README 的独立模式使用 `.env` 配置 `HA_URL`/`HA_TOKEN`/`HA_CONFIG_PATH`，并用 `docker compose ... up -d` 启动。 - README 说明首次启动会生成 API Key，可从日志或 HA 配置目录中的文件读取。 ### FAQ - **该选哪种安装方式？**：README 建议：HA OS/Supervised 用 Add-on；HA Container 用独立 Docker。 - **Token 从哪来？**：README 指引在 HA UI 的 Profile 里创建 Long-Lived Access Token。 - **连接不通怎么排查？**：先看容器日志确认 API key，再确认 IDE 指向 `http://:8099`。 ## Source & Thanks > Created by [Coolver](https://github.com/Coolver). Licensed under MIT. > > [Coolver/home-assistant-vibecode-agent](https://github.com/Coolver/home-assistant-vibecode-agent) — ⭐ 548 --- Source: https://tokrepo.com/en/workflows/home-assistant-vibecode-agent-mcp-agent-for-home-assistant Author: MCP Hub