Risk-Aware Code Review: Auto Approve Low-Risk Changes
LiveReview LiveReview LiveReview - Free, Risk-Aware Code Review: Auto Approve Low-Risk Changes | Product Hunt LiveReview - Free, Risk-Aware Code Review: Auto Approve Low-Risk Changes | Product Hunt GitHub Install Now

We'd appreciate a star

How to install homeassistant-ai/ha-mcp. Official installation instructions. Project installation guide. Framework or library installation. Build installation instructions. How to setup and install from GitHub. Installation steps and setup instructions. Official docs and installation instructions GitHub.

homeassistant-ai/ha-mcp Installation Guide

How to install homeassistant-ai/ha-mcp. Official project installation instructions and setup guide.

⚡

Automated Install (Recommended)

Quick installation instructions for homeassistant-ai/ha-mcp. This is the fastest way to complete project installation and setup.

Install via curl

curl -fsSL https://hexmos.com/ipm-install | bash && 
ipm i homeassistant-ai/ha-mcp
or

Install via npx

npx @hexmos/ipm i homeassistant-ai/ha-mcp

Prerequisites

Home Assistant

server

Version: 2026.8.0 or newer

HACS

integration

Docker

container

Python

language

Manual Installation Methods

Manual installation instructions. How to install from GitHub source.

Home Assistant Integration (Recommended)

HACS

Home Assistant Marketplace

Restart Home Assistant

Add HA-MCP Integration

Configure HA-MCP Server

Home Assistant Add-on (for OS/Supervised installs)

Add HA-MCP Repository to Home Assistant

Install HA-MCP Server Add-on

Start the Add-on

Check Logs for URL

Docker (HTTP server)

docker run ghcr.io/homeassistant-ai/ha-mcp

PyPI / uvx (HTTP server)

pip install ha-mcp

uvx ha-mcp@latest

Manual Install (Custom Component)

git clone https://github.com/homeassistant-ai/ha-mcp

cd ha-mcp

cp -r custom_components/ha_mcp_tools/config/custom_components/ha_mcp_tools/

Restart Home Assistant

Add HA-MCP Integration

Demo Server (macOS)

curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh

Download Claude Desktop

Restart Claude Desktop

Demo Server (Linux)

curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-linux.sh | sh

Install community Claude Desktop for Linux

Restart Claude Desktop

Demo Server (Windows)

irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex

Download Claude Desktop

Restart Claude Desktop

Post Installation Steps

  • Configure the HA-MCP integration with access tokens or user credentials.
  • Copy the connect URL from the HA-MCP Server configuration screen and paste it into your AI client.
  • For the Home Assistant Add-on, check the Logs tab for the unique MCP URL.
  • For Docker/PyPI installs, connect your client to the provided secret URL.
  • For demo servers, follow the 'Connect your own Home Assistant' link after setup to integrate with your instance.
← Back to serverAll Installation Guides