# Ha MCP

> Ha MCP is an open-source MCP server for productivity. MCP server for managing and automating Home Assistant from AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, macOS, Linux, Windows, CLI
- **Website:** https://homeassistant-ai.github.io/ha-mcp/
- **Repository:** https://github.com/homeassistant-ai/ha-mcp
- **GitHub stars:** 7,908
- **License:** MIT
- **MCP Registry name:** io.github.homeassistant-ai/ha-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Ha MCP lets AI assistants talk to a Home Assistant installation in natural language. You can control devices, read states, manage automations and scripts, and edit dashboards without writing configuration by hand.

It can run as a Home Assistant custom component installed via HACS, as an app on Home Assistant OS, or as a local stdio server installed from PyPI or a container image. The site says it exposes 87 tools in six groups: search, control, manage, monitor, system and flexible setup.

It is aimed at smart home owners who use clients such as Claude, ChatGPT or Cursor.

## Features

- **Entity search:** Fuzzy search across entities and configuration.
- **Device control:** Calls services and runs bulk operations on devices.
- **Automation management:** Creates and edits automations, scripts and helpers.
- **Dashboard editing:** Adds cards and changes dashboards.
- **Debugging aids:** Reads history, statistics and automation traces.
- **Backup and updates:** Handles backup, restore and system updates.

## Good for

- Create an automation by describing it
- Debug a failing motion-sensor automation
- Add a card to a dashboard
- Build a movie-mode script
- Review device history and statistics

## Install

### Claude Code (Terminal)

```sh
claude mcp add ha-mcp -- uvx ha-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `ha_call_service`: Call a Home Assistant service
- `ha_bulk_control`: Control several devices at once
- `ha_deep_search`: Deep search of configuration
- `ha_config_set_automation`: Create or update an automation
- `ha_config_get_automation`: Read an automation
- `ha_config_set_script`: Create or update a script
- `ha_config_set_dashboard`: Create or update a dashboard
- `ha_config_set_helper`: Create or update a helper

## FAQ

### Which Home Assistant installs work?

The custom component supports Home Assistant OS, Supervised, Container and Core.

### Does it cost anything?

The site states no paid subscription is required, and the license is MIT.

### Which AI clients work?

Claude, ChatGPT, Cursor, Copilot and others that support MCP.

### Is Ha MCP free?

Yes. Ha MCP is open source, so you can use and self-host it for free.

### How do I add Ha MCP to Claude Code?

Run this command in your terminal: claude mcp add ha-mcp -- uvx ha-mcp

### What are the best alternatives to Ha MCP?

The closest alternatives to Ha MCP are Concord MCP, note1, CalderFlow, nicemails and ConvertAudioToText.

## Alternatives

- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Panes](https://ai-powered.com/mcp/panes): Panes is a paid MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ha-mcp
