by Coolver
Home Assistant MCP server agent. Enable Claude Code, Cursor, VS Code or any MCP-enabled IDE to help you vibe-code and manage Home Assistant: create and debug automations, design dashboards, tweak themes, modify configs, and deploy changes using natural language
# Add to your Claude Code skills
git clone https://github.com/Coolver/home-assistant-vibecode-agentGuides for using ai agents skills like home-assistant-vibecode-agent.
Last scanned: 5/13/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-13T06:49:27.655Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": false
}No comments yet. Be the first to share your thoughts!
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:
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 service that exposes a safe REST API and toolset, allowing AI assistants (Claude Code, Cursor, VS Code, Antigravity, and any MCP-enabled IDE) to safely work with your Home Assistant instead of just generating YAML in the dark.
It supports two deployment modes:
| Mode | For whom | How it runs | |------|----------|-------------| | Supervisor (Add-on) | Home Assistant OS / Supervised | Installed via HA Add-on Store (default) | | Standalone (Docker) | HA Container in Docker / Proxmox / NAS | Runs as a separate Docker container |
Both modes provide the same core functionality. The only difference: Add-on management (install/uninstall/restart add-ons) requires the Supervisor and is not available in standalone mode.
Most MCP integrations for Claude, Cursor, VS Code or Antigravity run only on your local machine and talk to Home Assistant over SSH, sometimes with the REST API.
For serious Home Assistant work, that is not enough.
Home Assistant is not just a set of YAML files. It exposes internal APIs, runtime state, entities, services and capabilities that are much easier and safer to access from inside Home Assistant itself.
SSH-based integrations often force the AI to generate and run temporary helper scripts on every request. Since those scripts can change every time, the result is hard to predict, hard to repeat and risky to rely on.
This project uses a different architecture.
The project is split into two modules:
Runs inside, or alongside, Home Assistant.
It has native access to relevant APIs, files, entities, services and runtime state, and exposes a safe, well-defined interface for external tools.
Runs on your computer alongside your AI IDE, such as Cursor, VS Code, Claude Desktop or Antigravity.
It talks to the Agent over a controlled API instead of relying on SSH hacks.
This makes Home Assistant automation faster, safer, more predictable and repeatable.
The AI IDE gets exactly the actions and data it needs through a stable API, instead of constantly inventing ad-hoc scripts.
It also improves context efficiency.
Instead of loading huge YAML files, full entity dumps, logs or generated scripts into the prompt, the Agent can return only the relevant context: selected entities, services, automation fragments, validation results, errors or structured summaries.
The result is less noise, fewer tokens, fewer wrong assumptions and more reliable edits.
The MCP server gives your AI IDE a standard way to talk to Home Assistant.
The Agent gives it safe, native access to Home Assistant itself.
Together, they replace fragile SSH-based scripting with a stable, structured and context-efficient automation layer
For users running Home Assistant OS or Supervised installation.
This is the standard deployment — the agent runs as a managed add-on inside Home Assistant with full access to Supervisor API.
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
For users running Home Assistant Container without Supervisor (e.g., in Proxmox LXC/VM, Synology NAS, or plain Docker Compose).
The agent runs as a separate Docker container alongside your Home Assistant instance and connects via a Long-Lived Access Token.
git clone https://github.com/Coolver/home-assistant-vibecode-agent.git
cd home-assistant-vibecode-agent
cp .env.example .env
Edit .env with your values:
HA_URL=http://192.168.1.100:8123
HA_TOKEN=your_long_lived_access_token_here
HA_CONFIG_PATH=/path/to/homeassistant/config
docker compose -f docker-compose.standalone.yml up -d
The agent auto-generates an API key on first start. View it in the logs:
docker compose -f docker-compose.standalone.yml logs | grep "API Key"
Or read it directly from the config directory:
cat /path/to/homeassistant/config/.ha_cursor_agent_key
The agent is now available at http://<host-ip>:8099. Configure your MCP client (Cursor, VS Code, etc.) to connect using the API key from step 4.
This agent 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](https://www.npmjs.com/package/@coolver