Home Assistant MCP Server

Integrates with Home Assistant to provide smart home control capabilities via Model Context Protocol (MCP).

Local serverstdio 3

What is the Home Assistant MCP server?

If you already use Home Assistant, the home assistant mcp server is the piece that lets your assistant work with it directly. Integrates with Home Assistant to provide smart home control capabilities via Model Context Protocol (MCP).

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Prompts — The Prompts tool exposed by this server
  • Tools — The server implements control for various Home Assistant domains. Currently supports: - 💡 Lights: Turn on/off, brightness control - 🌡️ Climate
  • Debugging — Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the [MCP

Credentials and setup notes

Configuration is passed through the environment: HOMEASSISTANT_TOKEN, HOMEASSISTANT_BASE_URL, UV_PUBLISH_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

The server ships on npm as @modelcontextprotocol/inspector, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Home Assistant's toolset — Prompts, Tools, Debugging — is a fair guide to whether it matches your workflow. It is maintained by miguelg719; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Home Assistant's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
PromptsThe Prompts tool exposed by this server.
ToolsThe server implements control for various Home Assistant domains. Currently supports: - 💡 Lights: Turn on/off, brightness control - 🌡️ Climate: Temperature control, HVAC modes - 🔒 Locks: Lock/unlock functionality - 🚨
DebuggingSince MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).

How to install the Home Assistant MCP server

"mcpServers": {
    "home-assistant-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/home-assistant-server",
        "run",
        "home-assistant-server"
      ]
    }
  }

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
HOMEASSISTANT_TOKENCredential the server authenticates with.Yes
HOMEASSISTANT_BASE_URLEndpoint or connection string the server talks to.Yes
UV_PUBLISH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Home Assistant to Prompts.
  • Use Home Assistant to Tools.
  • Use Home Assistant to Debugging.

Frequently asked questions

Currently, it supports control for lights (on/off, brightness), climate (temperature, HVAC modes), locks (lock/unlock), alarm control panels (arm/disarm), and humidifiers (humidity).