ha-mcp

Name: ha-mcp
Author: homeassistant-ai

Community

MCP server by homeassistant-ai · updated yesterday · ★ 5.1k

Score 94

Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. ha-mcp is a community project by homeassistant-ai, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit in the past day

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, 5,139 stars, original repository

Security

Not checked yet. What we check

Install ha-mcp

Built from the published package, never by AI

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

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install ha-mcp in Claude Code

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

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install ha-mcp in Claude Desktop

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

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install ha-mcp in Cursor

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

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install ha-mcp in VS Code

codex mcp add ha-mcp -- uvx ha-mcp

Step-by-step: install ha-mcp in Codex

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

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install ha-mcp in Antigravity CLI

gemini mcp add ha-mcp uvx ha-mcp

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install ha-mcp in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the ha-mcp block.

Alternatives to ha-mcp

All alternatives →

N8n MCP czlonkowski

Integration between n8n workflow automation and Model Context Protocol (MCP)

AAA Local 33k/wk

Instantdb MCP instantdb

Model Context Protocol (MCP) server for managing Instant apps, schemas, and permissions!

AAA Local 11k

MCP Servers BabylonJS

Bundled Model Context Protocol servers for Babylon.js authoring workflows

AAA Local 26k

Claude Flow CLI ruvnet

Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code

AAA Local 77k

Caveman Shrink JuliusBrussee

MCP proxy that compresses prose fields (tool descriptions, etc.) using caveman rules. Same accuracy, fewer context tokens.

AAA Local 114k

Pi MCP earendil-works

Standalone Model Context Protocol client for pi and other applications

AAA Local 1380k/wk

ha-mcp vs N8n MCP ha-mcp vs Instantdb MCP ha-mcp vs MCP Servers

ha-mcp: common questions

How do I install ha-mcp?

In Claude Code run claude mcp add ha-mcp -- uvx ha-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is ha-mcp the official server?

ha-mcp is a community project by homeassistant-ai, not verified by a company domain.

Is ha-mcp free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is ha-mcp safe to use?

It scores 94 of 100. Grades: maintenance A, licence A, quality A. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to ha-mcp?

Similar MCP servers: N8n MCP, Instantdb MCP, MCP Servers, Claude Flow CLI.

Does ha-mcp work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.