by Coolver
Provides a Home Assistant add‑on that exposes a safe REST API, allowing AI‑enabled IDEs such as Cursor, VS Code, Claude, and any MCP‑compatible editor to analyze, create, and deploy automations, Lovelace dashboards, themes, HACS integrations and more using natural‑language commands.
Home Assistant Vibecode Agent runs inside Home Assistant as an add‑on. It gives AI assistants direct, authenticated access to Home Assistant’s REST and WebSocket APIs, the file system under /config, Git versioning, and Supervisor/HACS operations. The agent turns natural‑language requests from an MCP‑enabled IDE into concrete Home Assistant actions—creating automations, scripts, helpers, dashboards, themes, installing HACS repositories, and handling roll‑backs.
https://github.com/coolver/home-assistant-vibecode-agent.Do I need to be an HA expert? The tool is aimed at power users. You should understand the impact of automations and be comfortable reviewing generated YAML before it is applied.
What if the AI makes a mistake? All changes are committed to a Git repository with a clear message. You can view the history and roll back to any previous commit instantly.
Is my Home Assistant secure?
The agent requires a bearer token for every request (except health check). It validates paths, isolates file access to /config, and validates configuration before reloading.
Can I use it with other IDEs? Yes, any IDE that implements the MCP protocol and can send HTTP requests to the agent’s API will work.
How are HACS integrations handled? The agent talks to the HACS WebSocket endpoint, allowing you to search, install, update, and remove community repositories with a single command.
What ports does the add‑on use? By default the API is exposed on port 8099 (configurable in the add‑on settings).
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 add-on enables Cursor, Visual Studio Code (VS Code), or any MCP-enabled IDE to:
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
Full YouTube Demo:
HA Vibecode Agent is a Home Assistant add-on that exposes a safe on-board REST API and toolset, allowing AI assistants (Cursor, VS Code, Claude, Continue, and any MCP-enabled IDE) to work with your Home Assistant instead of just generating YAML in the dark.
✅ Read your full configuration — entities, automations, scripts, helpers
✅ Understand your devices — capabilities, relations, and usage patterns
✅ Learn existing logic — analyze how your current automations and scripts behave
✅ Create complete systems — multiple interconnected automations in seconds
✅ Generate helpers and sensors — tailored to your actual setup and needs
✅ Write optimized scripts — based on real entities, areas, and devices
✅ Refactor existing logic — improve or merge automations instead of starting from scratch
✅ Create and update Lovelace dashboards — fully programmatically
✅ Add, remove, or rearrange cards — stat, graphs, history, custom cards, and more
✅ Control layouts and views — organize rooms, areas, and scenarios
✅ Design and tweak themes — colors, typography, and styles for a personalized UI
✅ Git-based versioning — every change is tracked with meaningful commit messages
✅ Human-readable commits — AI explains what changed and why
✅ Configuration validation — test before apply to reduce breaking changes
✅ One-click rollback — revert to a previous state if something goes wrong
✅ Activity log — full audit trail of what the agent did and when
✅ Install and configure HACS — unlock 1000+ community integrations
✅ Search repositories — themes, plugins, custom components, dashboards
✅ Install integrations — one-command setup for new HACS components
✅ Keep things fresh — update all HACS repositories from a single place
Result:
You describe your goal → AI inspects your Home Assistant → designs a custom solution → and deploys it on-board automatically. 🚀
Most MCP integrations I’ve seen for Cursor, VS Code or Claude work only on your local machine and talk to Home Assistant over SSH and sometimes the REST API.
For serious Home Assistant work, that’s not really enough:
Home Assistant is not just a bunch of YAML files. It exposes multiple internal APIs, and some of the most important ones are only available from inside HA itself over the WebSocket API.
When you access HA only via SSH, the AI usually has to generate and upload a helper script on every request, then execute it blindly on the host. Since that script can be different every time, each request is a bit of a black box — more like playing Russian roulette than doing reliable automation.
Because of that, I chose a different architecture.
This project is split into two modules:
Home Assistant Agent (this module) – runs inside Home Assistant (as an add-on), has native access to all relevant APIs, files and services, and exposes a safe, well-defined interface for external tools.
Home Assistant MCP server – runs on your computer alongside your AI IDE (Cursor, VS Code, etc.) and talks to the Agent over a controlled API instead of SSH hacks (installation steps below)
This design makes working with Home Assistant faster, more predictable, safer and repeatable. Your AI IDE gets exactly the actions and data it needs — through a stable API — instead of constantly inventing ad-hoc scripts and hoping they behave correctly.
/config)Example AI interactions:
Complete add-on lifecycle management – install, configure, and control services!
Complete HACS integration via WebSocket – browse 1000+ custom integrations!
Open your Home Assistant UI (usually http://homeassistant.local:8123):
https://github.com/coolver/home-assistant-vibecode-agentStill in Home Assistant UI:
You'll see this interface:
Click the Cursor or VS Code tab (depending on which IDE you want to use with Home Assistant) and follow the setup instructions. You’ll need to install and configure Cursor or VS Code so they can connect to the HA Agent via the MCP protocol.
That’s it — you’re ready to start working with your Home Assistant scripts, automations and dashboards using AI. If you find this project useful and want to support its development, please consider giving it a GitHub Star ⭐
YouTube Installation guide: how to install the Home Assistant Cursor Agent
This add-on enables AI IDE to autonomously manage your Home Assistant through natural language - no manual copy-pasting needed!
This tool is designed for experienced Home Assistant users who understand what they're doing.
Use at your own risk. The automatic backup system minimizes risk but doesn't eliminate it.
Once connected, just describe what you want in natural language:
Show me all my climate entities and their current states
Analyze my automations and suggest optimizations
Create a smart lighting automation for movie mode
AI will autonomously read your configuration, create components, and deploy everything automatically!
That's it! AI IDE will use the MCP protocol to communicate with your Home Assistant.
Learn more: MCP Home Assistant on GitHub | NPM Package
Build Smart Climate Control:
Install a smart climate control system for my TRV radiators.
Analyze my current devices, create automations for efficient heating
with predictive shutdown, buffer radiators, and adaptive cooldowns.
Set up monitoring sensors and dashboard.
AI will autonomously:
Optimize Existing System:
My heating wastes energy. Analyze my current climate automations
and optimize for efficiency while maintaining comfort.
Debug Issues:
My bedroom lights automation isn't working. Check the logs,
find the problem, and fix it.
With this add-on and MCP integration, AI IDE can:
✅ Analyze YOUR configuration - detects your actual devices and entities
✅ Create complex systems autonomously - 10+ interconnected automations
✅ Tailored to your setup - uses your specific entity IDs and device capabilities
✅ Automatic backups - every change is Git-versioned with meaningful commit messages
✅ View change history - ask AI to show recent commits and what changed
✅ Easy rollback - ask AI to rollback to any previous version by description or date
✅ Intelligent debugging - reads logs, finds issues, fixes them
✅ Error recovery - can rollback if something goes wrong
✅ End-to-end deployment - from analysis to production
Stop writing YAML manually! Just describe what you want. 🚀
For complete API documentation, authentication details, and usage examples, see DEVELOPMENT.md.
Quick access:
http://homeassistant.local:8099/docs (when installed)http://homeassistant.local:8099/redoc (when installed)# No auth required for health check
curl http://homeassistant.local:8099/api/health
Example response:
{
"status": "healthy",
"version": "2.0.1"
}
curl -H "Authorization: Bearer YOUR_AGENT_KEY" \
http://homeassistant.local:8099/api/logs/?limit=50
curl -H "Authorization: Bearer YOUR_AGENT_KEY" \
http://homeassistant.local:8099/api/backup/history
/configFor development setup, project structure, API documentation, and local development instructions, see DEVELOPMENT.md.
Contributions are welcome! If you'd like to contribute:
For detailed contribution guidelines, see CONTRIBUTING.md.
This add-on enables Cursor AI to:
User: "Install smart climate control system"
↓
AI via Agent:
1. Reads current TRV entities
2. Creates backup
3. Creates 7 input helpers
4. Adds 12 template sensors to configuration.yaml
5. Creates 5 scripts
6. Creates 10 automations
7. Reloads all components
8. Validates installation
9. Shows dashboard YAML for user to add
↓
User: "Show me the last 10 changes to my configuration"
↓
AI via Agent:
1. Calls `ha_git_history` to get commit history
2. Displays commits with meaningful messages:
- "Add automation: Control lights when motion detected"
- "Update theme: Change primary color to blue"
- "Add helper: Enable/disable climate system"
3. Shows timestamps and commit hashes
4. Helps identify which changes to review
User: "Something broke! Rollback to the version from yesterday"
↓
AI via Agent:
1. Gets recent commit history
2. Finds commits from yesterday
3. Shows options with descriptions
4. Rolls back to selected version
5. Verifies rollback was successful
User: "Rollback to when I added the motion sensor automation"
↓
AI via Agent:
1. Searches commit history for "motion sensor automation"
2. Finds matching commit
3. Shows commit details
4. Rolls back to that specific version
3. Restarts HA
4. Verifies restoration
.git folder in /config if not existsmax_backups)/configThis error means Node.js is not installed or not found in your system PATH.
Solution: Install Node.js (v18.0.0 or higher) on the computer where Cursor is running:
Download and install Node.js from https://nodejs.org Restart Cursor completely after installation Verify installation by running node --version in a terminal Important: Node.js must be installed on your computer (where Cursor runs), not on the Home Assistant server.
Check logs: Supervisor → HA Vibecode Agent → Logs
Common issues:
Authorization: Bearer YOUR_AGENT_KEY/config/config/ha_vibecode_git)git_versioning_auto setting for auto/manual commit mode/config is writableMIT License - See LICENSE file
Ready to give your AI full control of Home Assistant? Install now! 🚀
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by modelcontextprotocol
An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.
by danny-avila
Provides a self‑hosted ChatGPT‑style interface supporting numerous AI models, agents, code interpreter, image generation, multimodal interactions, and secure multi‑user authentication.
by block
Automates engineering tasks on local machines, executing code, building projects, debugging, orchestrating workflows, and interacting with external APIs using any LLM.
by RooCodeInc
Provides an autonomous AI coding partner inside the editor that can understand natural language, manipulate files, run commands, browse the web, and be customized via modes and instructions.
by pydantic
A Python framework that enables seamless integration of Pydantic validation with large language models, providing type‑safe agent construction, dependency injection, and structured output handling.
by mcp-use
A Python SDK that simplifies interaction with MCP servers and enables developers to create custom agents with tool‑calling capabilities.
by lastmile-ai
Build effective agents using Model Context Protocol and simple, composable workflow patterns.
by Klavis-AI
Provides production‑ready MCP servers and a hosted service for integrating AI applications with over 50 third‑party services via standardized APIs, OAuth, and easy Docker or hosted deployment.
by nanbingxyz
A cross‑platform desktop AI assistant that connects to major LLM providers, supports a local knowledge base, and enables tool integration via MCP servers.