Connecting an AI to Hearth

Hearth exposes a remote MCP (Model Context Protocol) connector protected by OAuth 2.1. Any MCP-capable client can use it. Your connector URL is shown in the dashboard under AI clients; it looks like https://<your-hearth>/mcp.

What the AI can do

• Read areas, entities, states, and the service catalog (cameras, locks, and locations are never exposed).
• Create, validate, edit, and delete automations, scenes, and scripts, the same way the Home Assistant UI editor does.

What it can never do

Call services, trigger automations, run scripts, or change device state directly. This is enforced twice: in Hearth and inside the integration running on your Home Assistant.

Claude

claude.ai → Settings → Connectors → Add custom connector → paste the URL → Connect. Claude Code: claude mcp add --transport http hearth <url>.

ChatGPT

Requires Plus, Pro, Business, Enterprise, or Edu. Settings → Apps & Connectors → Advanced → Developer mode → create a connector with OAuth authentication.

Gemini

Gemini CLI supports remote MCP servers on every account: gemini mcp add --transport http hearth <url>. The Gemini app supports custom MCP servers only inside Gemini Spark (AI Pro/Ultra, US). Treat Gemini support as beta.

Managed AI

Prefer not to bring your own AI? The Managed plan runs Claude for you and answers inside Home Assistant's Assist as the Hearth AI conversation agent.