Skip to main content
0
H

Ha Mcp

The Unofficial and Awesome Home Assistant MCP Server

Rating

0.0

Votes

0

score

Downloads

0

total

Price

Free

Sign in with your account

Works With

Claude CodeCursorWindsurfVS CodeDeveloper tool

About

⚠️ Breaking change in OAuth mode (v7.0.0) — Set HOMEASSISTANT_URL server-side. The consent form now accepts only the token. Migration guide →

# The Unofficial and Awesome Home Assistant MCP Server

A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant. Using natural language, control smart home devices, query states, execute services and manage your automations.

🚀 Get Started

Full guide to get you started with Claude Desktop (~10 min)

No paid subscription required. Click on your operating system:

    

Quick install (~5 min)

🍎 macOS

  1. 1.Go to claude.ai and sign in (or create a free account)
  2. 2.Open Terminal and run:

```sh

curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh

```

  1. 1.Download Claude Desktop (or restart: Claude menu → Quit)
  2. 2.Ask Claude: "Can you see my Home Assistant?"

You're now connected to the demo environment! Connect your own Home Assistant →

🪟 Windows

  1. 1.Go to claude.ai and sign in (or create a free account)
  2. 2.Open Windows PowerShell (from Start menu) and run:

```powershell

irm https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-windows.ps1 | iex

```

  1. 1.Download Claude Desktop (or restart: File → Exit)
  2. 2.Ask Claude: "Can you see my Home Assistant?"

You're now connected to the demo environment! Connect your own Home Assistant →

🏠 Home Assistant OS (Add-on)

  1. 1.Add the repository to your Home Assistant instance:

[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fhomeassistant-ai%2Fha-mcp)

  1. 1.Install "Home Assistant MCP Server" from the Add-on Store and wait for it to complete
  2. 2.Click Start, then open the Logs tab to find your unique MCP URL
  3. 3.Configure your AI client with that URL

No token or credential setup needed — the add-on connects to Home Assistant automatically.

Full add-on documentation →

🧙 Setup Wizard for 15+ clients

Claude Code, Gemini CLI, ChatGPT, Open WebUI, VSCode, Cursor, and more.

Having issues? Check the [FAQ & Troubleshooting](https://homeassistant-ai.github.io/ha-mcp/faq/)

💬 What Can You Do With It?

Just talk to Claude naturally. Here are some real examples:

Don't lose this

Three weeks from now, you'll want Ha Mcp again. Will you remember where to find it?

Save it to your library and the next time you need Ha Mcp, it’s one tap away — from any AI app you use. Group it into a bench with the rest of the team for that kind of task and you can pull the whole stack at once.

⚡ Pro tip for geeks: add a-gnt 🤵🏻‍♂️ as a custom connector in Claude or a custom GPT in ChatGPT — one click and your library is right there in the chat. Or, if you’re in an editor, install the a-gnt MCP server and say “use my [bench name]” in Claude Code, Cursor, VS Code, or Windsurf.

🤵🏻‍♂️

a-gnt's Take

Our honest review

This plugs directly into your AI and gives it new abilities it didn't have before. The Unofficial and Awesome Home Assistant MCP Server. Once connected, just ask your AI to use it. It's completely free and works across most major AI apps. This one just landed in the catalog — worth trying while it's fresh.

Tips for getting started

1

Tap "Get" above, pick your AI app, and follow the steps. Most installs take under 30 seconds.

2

You'll sign in with your existing account the first time. After that, it just works.

What's New

Version 1.0.06 days ago

Imported from GitHub

Ratings & Reviews

0.0

out of 5

0 ratings

No reviews yet. Be the first to share your experience.