Skip to content

Installation

Requirements

  • Home Assistant OS or Home Assistant Supervised. The add-on runs as a Supervisor-managed container; Container and Core installations have no add-on support.
  • Architecture aarch64 (Raspberry Pi 4/5 and other 64-bit ARM boards) or amd64 (NUC, VM, x86 server).

Add the repository

Click the button:

Add repository

Or manually: Settings → Add-ons → Add-on store → ⋮ → Repositories, then paste:

https://github.com/Devitek/mcp-ha

Install and start

  1. Find MCP Home Assistant in the store (refresh the page if needed) and click Install. The Supervisor pulls a prebuilt image from GitHub Container Registry, this takes a few seconds.
  2. Click Start.

Get your API token

On first start, the add-on generates a random API token (32 bytes) and saves it into the Configuration tab of the add-on, in the api_token option. That tab is the only place showing the full value: the Log tab only ever shows a masked prefix such as d370f4f8**********, because a secret does not belong in logs.

Every installation gets its own token: reinstalling the add-on wipes its data and produces a fresh one. You can also set your own value in api_token at any time; restart the add-on to apply it. If the option ever looks empty, restart the add-on: saving the token there is retried at every start.

Next step: connect a client.