macOS Setup Guide

Go to claude.ai and create a free account.

Open Terminal and paste:

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

This installs the required tools and configures Claude Desktop for the demo environment.

brew install uv

{
  "mcpServers": {
    "Home Assistant": {
      "command": "uvx",
      "args": ["ha-mcp@latest"],
      "env": {
        "HOMEASSISTANT_URL": "https://ha-mcp-demo-server.qc-h.net",
        "HOMEASSISTANT_TOKEN": "demo"
      }
    }
  }
}

Download and install Claude Desktop from claude.ai/download.

Already have it? Restart it: Claude menu → Quit Claude, then reopen.

Open Claude Desktop and ask:

Can you see my Home Assistant?

Claude should respond with a list of entities from the demo environment (lights, sensors, switches, etc.).

The demo environment is a real Home Assistant you can experiment with:

Try asking Claude:

• "Turn on the kitchen lights"
• "What's the temperature in the living room?"
• "Create an automation that turns off all lights at midnight"

Ready to use your own Home Assistant? Edit the config file:

open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Replace the demo values:

{
  "mcpServers": {
    "Home Assistant": {
      "command": "uvx",
      "args": ["ha-mcp@latest"],
      "env": {
        "HOMEASSISTANT_URL": "http://homeassistant.local:8123",
        "HOMEASSISTANT_TOKEN": "your_long_lived_token"
      }
    }
  }
}

Then restart Claude: Claude menu → Quit Claude, then reopen.

We'd love to hear how you're using ha-mcp!

• GitHub Discussions — Share your automations, ask questions
• GitHub Issues — Report bugs or request features