Home Assistant MCP Setup Wizard
Configure the Home Assistant MCP Server for your AI assistant
Quick Setup — HA Custom Component
Runs the full ha-mcp server inside Home Assistant. Works on every Home Assistant installation type — Home Assistant OS, Supervised, Container, and Core.
- Install HA-MCP Custom Component from HACS, then restart Home Assistant.
- Go to Settings → Devices & Services → Add Integration, search HA-MCP Custom Component, and choose HA-MCP Server.
- Submit — creating the entry starts the server.
- Copy the connect URL from the entry's Configure screen (a notification points you there; the URL is also printed in the Home Assistant log).
- Paste it into your AI client — pick the client below for its exact config.
Need client-specific config, or a different install method (add-on, Docker, uvx, or local stdio)? Use the setup wizard below.
1 How is your MCP server running?
Alternative methods
Demo server (local stdio)
Prefer to run ha-mcp locally over stdio, or just try the public demo Home Assistant? These per-OS walkthroughs cover it. stdio has known transport issues; not recommended for a permanent setup.
macOS
Local or the Home Assistant App
Demo server
macOS
Local or the Home Assistant App
Linux
Local or the Home Assistant App
Demo server
Linux
Local or the Home Assistant App
Windows
Local or the Home Assistant App
Demo server
Windows
Local or the Home Assistant App