Claude AI

You can connect Claude Desktop to your Home Assistant instance using the Model Context Protocol (MCP) to control your smart home with natural language. This MCP server enables zero-configuration setup, secure authentication, real-time transport, and deep integration with all exposed entities and services, so you can interact with your home using conversational queries.

How to use

After you connect Claude Desktop to your Home Assistant MCP server, you can control your home with natural language. You can perform actions like turning lights on or off, checking temperatures, locking doors, setting scenes, and viewing energy usage. Speak naturally and Claude will translate your requests into Home Assistant actions and queries while relying on secure, real-time communication.

How to install

Prerequisites you need before starting: Node.js 20+ and Docker for building and running containers. A working Home Assistant instance is required to provide the MCP connection.

# Step 1: Add MCP repository to Home Assistant
Settings → Add-ons → Add-on Store → ⋮ → Repositories
Add: https://github.com/mtebusi/ha-mcp

Step 2: Install the Claude AI MCP Bridge add-on. Find "Claude AI MCP Bridge for Smart Home Control", click Install, then Start.

Step 3: Connect Claude Desktop. Open Claude Desktop, go to Settings → Custom Connectors → Add Remote MCP Server, and enter the remote URL below. The add-on will be discovered automatically.

http://homeassistant.local:8123

Security and connectivity notes

This integration is secured by OAuth2 authentication and supports SSL for encrypted communication. Real-time updates are delivered via Server-Sent Events (SSE) to keep you up to date with the latest state of your home.

Configuration overview

The MCP server exposes a single http connection to Claude Desktop for remote access. No local command is required beyond the initial setup steps above.

Usage examples

Once connected, you can issue natural language requests such as: Turn on the living room lights, What's the temperature in the bedroom, Lock all doors, Set the house to night mode, Show me energy usage for today.

Available tools

Zero configuration

Best-in-class setup that works immediately after installation without manual configuration.

Natural language control

Control Home Assistant using conversational prompts and queries.

Full Home Assistant integration

Access all exposed entities and services for comprehensive control.

OAuth2 security

Secure authentication for MCP access with optional SSL support.

Real-time transport

Server-Sent Events (SSE) for live updates from Home Assistant.