MCP Home Assistant

Build smart home automations with AI - just describe what you want in natural language

You should start by installing the Home Assistant Vibecode Agent: https://github.com/Coolver/home-assistant-cursor-agent

Transform your smart home management! This MCP server enables Cursor AI, Visual Studio Code or your favourite IDE with MCP support to:

• Analyze your Home Assistant configuration and devices
• Create intelligent automations, scripts, and complete systems
• Monitor and troubleshoot through log analysis
• Install and manage HACS integrations (1000+ custom integrations!)
• Safely deploy changes with automatic Git versioning

No more manual YAML editing or searching through documentation!

Example: "Install smart climate control for my radiators" AI creates 10+ automations, helpers, sensors, and scripts optimized for YOUR TRVs.

Built on Model Context Protocol and powered by HA Vibecode Agent.

Key Features

• Natural language - describe what you want, AI builds it
• Device-aware - analyzes YOUR actual setup
• HACS integration - install and manage 1000+ custom integrations via WebSocket
• Auto-backup - every change saved in Git automatically with meaningful commit messages
• Meaningful commits - AI automatically generates descriptive commit messages explaining what and why changed
• Instant rollback - restore any previous version with one command
• Component management - automations, scripts, helpers, entities
• Log analysis - monitor system behavior, detect anomalies, suggest optimizations
• Debug assistance - AI reads logs and identifies issues automatically

---

What can you do?

AI assistants analyze your actual Home Assistant configuration and create smart automations tailored to YOUR devices:

Build Complex Systems from Scratch

• "Install HACS and then install Xiaomi Gateway 3 integration"
• "Install a smart climate control system for my TRV radiators with predictive shutdown and buffer mode"
• "Create a presence-based lighting system using my motion sensors and schedule"
• "Set up energy monitoring with notifications when consumption is high"

AI will:

1. Read your current configuration
2. Detect your devices and entities
3. Create automations, scripts, helpers
4. Test and validate everything
5. Deploy - all automatically!

Extend with Community Integrations

• "Install HACS for me"
• "Search for Xiaomi integrations in HACS"
• "Install Xiaomi Gateway 3 from HACS"
• "What themes are available in HACS?"
• "Update all my HACS repositories"

AI will:

1. Install HACS automatically
2. Search 1000+ community repositories
3. Install integrations, themes, plugins
4. Keep everything updated

Manage Add-ons & Services

• "Install Zigbee2MQTT and configure it for my Sonoff dongle"
• "Setup Mosquitto MQTT broker"
• "Install Node-RED for visual automations"
• "My Zigbee2MQTT isn't working - check the logs and fix it"
• "Update all my add-ons"

AI will:

1. Install add-ons (Zigbee2MQTT, Node-RED, ESPHome)
2. Auto-detect hardware (USB coordinators)
3. Configure options
4. Start/stop/restart services
5. Monitor logs and troubleshoot

Intelligent Configuration

• "Optimize my heating system based on room priorities and occupancy patterns"
• "Create smart scenes for movie night using my actual lights and media devices"
• "Build a security system with my door sensors and cameras"

Debug and Fix Issues

• "Why isn't my bedroom automation working? Check the logs and fix it"
• "My climate control keeps turning off early - analyze and improve the logic"

Monitor and Analyze

• "Analyze my logs and tell me if my heating system is working efficiently"
• "Check if my automations are triggering too often or missing events"
• "Compare actual system behavior with expected logic and suggest improvements"

No manual YAML editing. No copy-pasting. Just describe what you want!

---

Prerequisites

Before installing, you need:

1. Home Assistant running (any version)
2. HA Vibecode Agent v2.2.0+ installed as add-on
3. Agent Key from HA Vibecode Agent (auto-generated on first start)
4. AI-enabled editor installed (Cursor AI or VS Code + GitHub Copilot)

---

Quick Start (5 minutes)

Step 0: Install Node.js (if not already installed)

The MCP server requires Node.js to run on your computer (where your AI editor is installed):

1. Check if Node.js is already installed: open terminal and run node --version
2. If not installed or version is below v18.0.0, download and install from nodejs.org
3. After installation, verify: node --version should show v18.0.0 or higher
4. Important: Install Node.js on the computer where your AI editor runs, not on the Home Assistant server

Step 1: Install HA Vibecode Agent

Install the agent in your Home Assistant:

1. Go to Settings Add-ons Add-on Store
2. Click **** Repositories
3. Add: https://github.com/Coolver/home-assistant-cursor-agent
4. Install HA Vibecode Agent (v2.0.0+)
5. Start the agent

Step 2: Setup MCP in Your AI Editor

Get configuration from Home Assistant:

1. Open your Home Assistant (usually http://homeassistant.local:8123)
2. Go to Settings Add-ons HA Vibecode Agent
3. Click "Open Web UI" button
4. Click the Cursor or VS Code tab (depending on which IDE you want to use with Home Assistant) and **follow the setup instructio…