Skip to content
MCP server

Ha MCP

MCP server for managing and automating Home Assistant from AI assistants

Runs locallyActively maintainedStatus and history

The repository was last updated 6 hours ago and is published under MIT.

Pricing
Open source
Platforms
self-hosted, macOS, Linux
Runs
Locally
GitHub stars
7.9K
Last commit
today
Language
Python

About Ha MCP

Ha MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licensed; no paid subscription required

Prices change. Check homeassistant-ai.github.io before you buy.

Ha MCP 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 to Ha MCP

  1. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  2. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  3. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  4. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. Hostlet

    MCP server

    Create and share a document-answering AI page or website, and query other Hostlet AIs

    • 6 tools
    • Remote
    • Free
    • Productivity