The problem
How it works
The integration is enabled from Settings > System > AI, which shows a main MCP URL and one URL per set of tools. The Device control set gives an AI the same tools as Home Assistant’s own voice assistant, Assist, and only reaches entities you have exposed to voice assistants; the broader Home Assistant set can read every entity, the logs and history, and perform any action. You add the URL as a custom connector in Claude or Claude Desktop, as an MCP server in ChatGPT, or with one command in Claude Code, Codex or OpenCode, then sign in to Home Assistant through OAuth. After that you can ask the agent about the house or tell it to switch things, and Claude asks before each tool call.
Results and limitations
This is setup documentation from the Home Assistant project with no reported results, so it is marked planned.
Before you try it
Start with the Device control URL or turn on the main URL’s read-only option, and keep the number of exposed entities small: the full Home Assistant tool set can do anything an administrator can. Claude connects from Anthropic’s cloud even when you use Claude Desktop, so your instance has to be reachable from the internet, for example through Home Assistant Cloud. The integration does not support MCP sampling or notifications. Results depend on your setup and were not independently reproduced by Top 200 Repos.
Tools and repositories
- Tools
- Home Assistant · Claude, ChatGPT, Claude Code, Codex or OpenCode
- Prerequisites
- A Home Assistant instance with the Model Context Protocol integration, and internet access to it for cloud clients.
Try it yourself: Check the house before you leave
Fill the fields to adapt the prompt. Empty fields stay as visible [placeholders].
Using the Home Assistant tools, tell me the state of [What to check]. List anything that is not in its expected state ([Expected state]) and suggest the action you would take for each one, but do not change anything until I confirm. After I confirm, carry out only the actions I approve and read the states back to me.Connect the Device control URL, or a read-only main URL, for a first try.
Sources
- Model Context Protocol (opens in a new tab)
Project documentation · home-assistant.io · Undated · Source checked 12 Nov 2026, 18:03 UTC
What this source supports
- The integration lets an AI agent such as ChatGPT or Claude control devices and see the current state of the home, with Home Assistant as the MCP server
- Device control gives the same tools as Assist and only reaches exposed entities; the Home Assistant tool set reads all entities, logs and history and can perform any action
- The main URL can be limited to chosen tool sets, to administrators, or to read-only tools; each tool set also has its own URL
- Setup steps for Claude, Claude Desktop, ChatGPT, Claude Code, Codex and OpenCode with OAuth sign-in
- Claude connects from the cloud, so the instance must be reachable from the internet; sampling and notifications are not supported