HA Vibecode Agent

v1.0.0Business Applicationsstable

An MCP server and Home Assistant add-on that enables AI assistants to manage smart homes by creating automations, designing dashboards, and interacting with entities. It features native access to Home Assistant APIs, built-in Git versioning for safe

claudeclaudecodecursor-aihome-assistanthome-assistant-addons
Share:
554
Stars
0
Downloads
0
Weekly
0/5

What is HA Vibecode Agent?

HA Vibecode Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server and home assistant add-on that enables ai assistants to manage smart homes by creating automations, designing dashboards, and interacting with entities. it features native access to home as...

An MCP server and Home Assistant add-on that enables AI assistants to manage smart homes by creating automations, designing dashboards, and interacting with entities. It features native access to Home Assistant APIs, built-in Git versioning for safe

This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server and Home Assistant add-on that enables AI assi

Use Cases

Manage smart homes by creating automations and designing dashboards via AI.
Access Home Assistant entities with Git versioning for safe changes.
Coolver

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx ha-vibecode-agent

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use HA Vibecode Agent

The HA Vibecode Agent is an MCP server and Home Assistant add-on that gives AI assistants like Claude Code and Cursor native access to Home Assistant APIs, enabling them to autonomously create automations, design Lovelace dashboards, manage helper entities, install HACS integrations, and monitor logs — all from within an AI-enabled IDE. Every change is tracked with built-in Git versioning, providing a safety net for rollback when AI-generated configurations need revision. It is designed for developers and advanced users who want to use a professional coding workflow to build and maintain their smart home.

Prerequisites

  • Home Assistant OS or Supervised installation (or Docker for standalone mode)
  • A Home Assistant long-lived access token from Profile > Security > Long-lived access tokens
  • HA_CONFIG_PATH pointing to your Home Assistant configuration directory
  • Claude Code, Cursor, or another MCP-enabled IDE or client
1

Add the add-on repository to Home Assistant

In Home Assistant go to Settings > Add-ons > Add-on Store, open the repository menu, and add the vibecode agent repository URL.

# Add this URL in HA Add-on Store > Repositories:
https://github.com/Coolver/home-assistant-vibecode-agent
2

Install, configure, and start the add-on

Find HA Vibecode Agent in the store, click Install, configure your HA token in the add-on options, then click Start. The MCP server starts on port 8099.

3

Run in standalone Docker mode (non-HA OS)

Clone the repository, copy the example environment file, fill in your Home Assistant connection details, and start with Docker Compose using the standalone profile.

git clone https://github.com/Coolver/home-assistant-vibecode-agent.git
cd home-assistant-vibecode-agent
cp .env.example .env
# Set in .env:
# HA_URL=http://192.168.1.100:8123
# HA_TOKEN=your_long_lived_token
# HA_CONFIG_PATH=/path/to/homeassistant/config
docker compose -f docker-compose.standalone.yml up -d
4

Note your agent API key

The add-on generates an agent API key separate from your HA token. Find it in the add-on logs after first startup. This key authenticates MCP client requests.

5

Connect your MCP-enabled IDE

Configure your AI IDE (Claude Code, Cursor, VS Code) to connect to the agent's HTTP endpoint at http://homeassistant.local:8099 using the bearer token authentication.

HA Vibecode Agent Examples

Client configuration

Add this configuration to your MCP client settings. The agent is accessed over HTTP; use mcp-remote as a stdio bridge. Replace the host and API key with your actual values.

{
  "mcpServers": {
    "ha-vibecode-agent": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://homeassistant.local:8099",
        "--header",
        "Authorization:Bearer YOUR_AGENT_KEY"
      ]
    }
  }
}

Prompts to try

Once connected, use these prompts with Claude Code or your chosen AI IDE to manage your Home Assistant configuration.

- "List all entities in my home grouped by domain."
- "Create an automation that sends a notification when the front door sensor is open for more than 5 minutes."
- "Design a Lovelace energy dashboard with solar production and consumption cards."
- "Create a template sensor that shows the average temperature across all rooms."
- "Show recent Home Assistant error logs and suggest fixes for any automation failures."

Troubleshooting HA Vibecode Agent

Docker standalone mode fails to access HA configuration files

Make sure HA_CONFIG_PATH in your .env points to the actual Home Assistant config directory on the host machine, and that this path is mounted correctly in the docker-compose.standalone.yml volume definitions.

Git versioning shows uncommitted changes after every AI action

This is expected behavior — the agent commits changes automatically after each deployment. If commits are not appearing, check that the Git user identity is configured inside the container with `git config --global user.email` and `user.name`.

MCP tools are available but Home Assistant entity calls fail

Verify that HA_URL is reachable from inside the Docker container (use the host IP, not localhost). Check that HA_TOKEN is a valid long-lived access token with sufficient permissions. Test connectivity with `curl -H 'Authorization: Bearer YOUR_TOKEN' http://your-ha-ip:8123/api/` from inside the container.

Frequently Asked Questions about HA Vibecode Agent

What is HA Vibecode Agent?

HA Vibecode Agent is a Model Context Protocol (MCP) server that mcp server and home assistant add-on that enables ai assistants to manage smart homes by creating automations, designing dashboards, and interacting with entities. it features native access to home assistant apis, built-in git versioning for safe It connects AI assistants to external tools and data sources through a standardized interface.

How do I install HA Vibecode Agent?

Follow the installation instructions on the HA Vibecode Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with HA Vibecode Agent?

HA Vibecode Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is HA Vibecode Agent free to use?

Yes, HA Vibecode Agent is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

HA Vibecode Agent Alternatives — Similar Business Applications Servers

Looking for alternatives to HA Vibecode Agent? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.

n8n

189.1k

A comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou

LobeHub

77.5k

🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.

Jeecgboot

46.4k

AI 低代码平台,「低代码 + 零代码」双模式驱动:低代码一键生成前后端代码,零代码 5 分钟搭建系统,AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,消除 Java 项目 80% 的重复工作,提效而不失灵活。

CowAgent

44.7k

CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理,能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长,比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入,可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI,能处理文本、语音、图片和文件,可快速搭建个人AI助理和企业数字员工。

Minds Platform

39.2k

Platform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.

Astrbot

32.8k

AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨

Browse More Business Applications MCP Servers

Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "ha-vibecode-agent": { "command": "npx", "args": ["-y", "ha-vibecode-agent"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use HA Vibecode Agent?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides