Chapter 14 — The Oracle II: Let the AI Run the Lab

mkdir -p /srv/lab/compose/homeassistant && cd /srv/lab/compose/homeassistant

services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:latest
    container_name: homeassistant
    ports:
      - "8123:8123"
    environment:
      TZ: "Pacific/Honolulu"
    volumes:
      - /srv/lab/data/homeassistant:/config
      # Allow access to Zigbee/Z-Wave USB sticks
      - /dev/ttyUSB0:/dev/ttyUSB0:ro
      # Or for Zigbee on ConBee:
      # - /dev/ttyACM0:/dev/ttyACM0:ro
    network_mode: host  # HA needs this for mDNS and some automations
    restart: unless-stopped

docker compose up -d
docker compose logs -f  # wait for "INFO (MainThread) [homeassistant.runner]" then Ctrl-C

{
  "mcpServers": {
    "Home Assistant": {
      "command": "mcp-proxy",
      "args": [
        "--transport=streamablehttp",
        "--stateless",
        "http://homeassistant.local:8123/api/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
      }
    }
  }
}

claude mcp add-json "HA" '{
  "type": "http",
  "url": "http://homeassistant.local:8123/api/mcp",
  "oauth": {
    "clientId": "http://localhost:12345",
    "callbackPort": 12345
  }
}'

Your Home Assistant instance has these integrations:
- Home Assistant Cloud (cloud)
- Pi-hole (pi_hole) - 12,543 queries blocked today
- Immich (integration_example) - 14 photos synced
- Zigbee (zha) - 8 devices paired: 1 bulb, 3 motion sensors, 2 locks...

Currently active automations: 3
Last backup: 2 hours ago, 450 MB