Ha MCP

What you can do with Ha MCP

ha-mcp is an unofficial MCP server for configuring, building and debugging a Home Assistant smart home with an AI assistant, not just controlling devices: automations, scripts, scenes, helpers, dashboards, registries, backups and traces.

• ·Create and edit automations, scripts and scenes
• ·Debug automations from execution traces and logs
• ·Control devices and call services
• ·Manage areas, zones, labels, helpers and groups
• ·Build dashboards and manage add-ons, HACS and backups

What Ha MCP can and cannot do

What you need before using Ha MCP

Runtime

Custom component inside Home Assistant (recommended), the Home Assistant app/add-on (HA OS or Supervised), Docker image ghcr.io/homeassistant-ai/ha-mcp, or uvx ha-mcp@latest

Credentials

A long-lived access token (an administrator's is recommended) for Docker and uvx; not needed for the custom component or app

Also needed

Remote access via Nabu Casa, the Webhook Proxy app, Cloudflare Tunnel or a reverse proxy

Connect Ha MCP and confirm it works

1. Add https://github.com/homeassistant-ai/ha-mcp-integration as a custom HACS repository and install HA-MCP Custom Component, then restart Home Assistant
2. Settings → Devices & Services → Add Integration → HA-MCP Custom Component → HA-MCP Server
3. Copy the connect URL from the entry's Configure screen and paste it into your AI client
4. Alternatively use the Setup Wizard on the docs site for Docker, uvx or add-on configurations

claude mcp add ha-mcp -- uvx ha-mcp

claude mcp add ha-mcp -- docker run -i --rm ghcr.io/homeassistant-ai/ha-mcp:8.7.0

[mcp_servers.ha-mcp]
command = "uvx"
args = ["ha-mcp"]

[mcp_servers.ha-mcp]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/homeassistant-ai/ha-mcp:8.7.0"]

{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "ha-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/homeassistant-ai/ha-mcp:8.7.0"
      ]
    }
  }
}

{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "ha-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/homeassistant-ai/ha-mcp:8.7.0"
      ]
    }
  }
}

{
  "servers": {
    "ha-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}

{
  "servers": {
    "ha-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/homeassistant-ai/ha-mcp:8.7.0"
      ]
    }
  }
}

{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "ha-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/homeassistant-ai/ha-mcp:8.7.0"
      ]
    }
  }
}

{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "ha-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/homeassistant-ai/ha-mcp:8.7.0"
      ]
    }
  }
}

When to choose another server

• Hass-MCP#1,671

  You want a smaller Home Assistant server focused on states and service calls.

• Home Assistant MCP#11,645

  You prefer a server built around the Assist/conversation API.

What changed, and when this was checked

First listed

Sep 14, 2025

Latest version published

Oct 14, 2026

Version history

109 versions tracked (below)

Requirements evidence

Declared by the Official MCP Registry, last synced Oct 25, 2026. Not independently verified by MCP Toplist.

Profile checked

Oct 9, 2026 against README

Ranking data as of

Oct 25, 2026

Do you maintain Ha MCP? Claim it to correct or enrich this profile.

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

[![MCP Toplist](https://mcptoplist.com/badge/io.github.homeassistant-ai%2Fha-mcp.svg)](https://mcptoplist.com/server/io.github.homeassistant-ai%2Fha-mcp)

<a href="https://mcptoplist.com/server/io.github.homeassistant-ai%2Fha-mcp"><img src="https://mcptoplist.com/badge/io.github.homeassistant-ai%2Fha-mcp.svg" alt="MCP Toplist: #9 of 152,076" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.