# mcp-home-assistant
## 基本信息
- Slug: `coolver-mcp-home-assistant`
- Source: modelscope
- Publisher: @Coolver/mcp-home-assistant
- Categories: home-automation-and-iot / app-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@Coolver/mcp-home-assistant
## 简介
暂无描述。
## 安装提示

```bash
Connect to my Home Assistant and show me: 1. List of all my climate entities 2. Current status of the HA Vibecode Agent This will verify the MCP connection is working.
```

## MCP Server 详情

# 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](https://modelcontextprotocol.io/) and powered by [HA Vibecode Agent](https://github.com/Coolver/home-assistant-cursor-agent).

[![NPM Version](https://img.shields.io/npm/v/@coolver/home-assistant-mcp)](https://www.npmjs.com/package/@coolver/home-assistant-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

###  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](https://github.com/Coolver/home-assistant-cursor-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](https://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…