Home Assistant (ha-mcp)
MCP-Server von homeassistant-ai
Home-Assistant-Geräte, Zustände, Automatisierungen, Skripte und Dashboards in natürlicher Sprache steuern und konfigurieren.
Home Assistant (ha-mcp) installieren
Läuft auf deinem Rechner. Dein Client startet ihn mit diesem Befehl:
Braucht uv (Python) auf deinem Rechner. Die Schritte unten zeigen, wo der Befehl in jedem Client hingehört.
HOMEASSISTANT_URLYour Home Assistant URL.HOMEASSISTANT_TOKENgeheim Home Assistant long-lived access token.
Diesen Server teilen
Öffnet diese Seite mit dem Installationsbefehl und den Einrichtungsschritten.
mcp.tc/i/home-assistantÜber den Server
Ein inoffizieller, von der Community entwickelter Server, der einen KI-Assistenten mit einer Home-Assistant-Instanz verbindet. Damit kannst du Smart-Home-Geräte steuern, Entity-Zustände abfragen, Services aufrufen und Automatisierungen, Skripte und Dashboards in natürlicher Sprache verwalten.
Er kann als über HACS installierte Home-Assistant-Custom-Component, als Home-Assistant-App (Add-on), in Docker oder lokal mit uvx ha-mcp@latest laufen. Component und App stellen Streamable HTTP bereit und brauchen kein Zugriffstoken. Docker- und uvx-Setups benötigen HOMEASSISTANT_URL und ein langlebiges Zugriffstoken in HOMEASSISTANT_TOKEN. Für den stdio-Transport sind bekannte Probleme dokumentiert.
Was du damit machen kannst
- Smart-Home-Geräte steuern und Home-Assistant-Services aufrufen
- Entity-Zustände abfragen
- Automatisierungen und Skripte verwalten
- Dashboards konfigurieren
- Betrieb als HACS-Custom-Component, App, Docker oder uvx-Paket
- Optionale OIDC-Authentifizierung für den Fernzugriff
Tools
Home Assistant (ha-mcp) zeigt seine Tools nur Clients mit Schlüssel, deshalb können wir sie hier nicht auflisten.
Beispiel-Prompts
Schalte alle Lichter im Wohnzimmer aus
Wie hoch ist die aktuelle Temperatur im Schlafzimmer?
Erstelle eine Automatisierung, die das Licht an der Veranda bei Sonnenuntergang einschaltet
Liste meine Automatisierungen auf und sag mir, welche davon deaktiviert sind
Einrichtung
Jeder Client startet Home Assistant (ha-mcp) mit demselben Befehl auf deinem Rechner. Wähl deinen; die Seite merkt sich deine Wahl.
Claude Code
- Führe das in einem Terminal in deinem Projektordner aus:
claude mcp add --transport stdio home-assistant --env "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" --env "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" -- uvx ha-mcp@latest- Starte Claude Code und tippe
/mcp. home-assistant sollte als verbunden angezeigt werden.
Ergänze --scope user, damit er in jedem Projekt verfügbar ist. Ersetze die Platzhalter durch deine eigenen Werte.
Claude Desktop
- Öffne Settings → Developer → Edit Config. Das öffnet
claude_desktop_config.json. Füge hinzu:
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}- Speichere die Datei und starte Claude Desktop neu. Ersetze die Platzhalter durch deine eigenen Werte.
Braucht uv (Python) auf deinem Rechner. Die Datei liegt unter macOS in ~/Library/Application Support/Claude/ und unter Windows in %APPDATA%\Claude\.
Cursor
Zu Cursor hinzufügen (öffnet in einem neuen Tab)
Oder trag ihn von Hand in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (dieses Projekt) ein:
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}Braucht uv (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
VS Code
Füge ihn zu .vscode/mcp.json hinzu. VS Code fragt beim ersten Mal nach dem Secret und speichert es sicher:
{
"servers": {
"home-assistant": {
"type": "stdio",
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "${input:homeassistant-token}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "homeassistant-token",
"description": "HOMEASSISTANT_TOKEN",
"password": true
}
]
}Braucht uv (Python) auf deinem Rechner.
Devin Desktop
- Füge ihn zu
~/.config/devin/mcp_config.json(macOS und Linux) oder%APPDATA%\devin\mcp_config.json(Windows) hinzu:
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}- Aktualisiere die Liste der MCP-Server in Cascade. Ersetze die Platzhalter durch deine eigenen Werte.
Devin Desktop ist der neue Name von Windsurf.
Codex
codex mcp add home-assistant --env "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" --env "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" -- uvx ha-mcp@latestOder bearbeite ~/.codex/config.toml direkt:
[mcp_servers.home-assistant]
command = "uvx"
args = ["ha-mcp@latest"]
env = { HOMEASSISTANT_URL = "<YOUR_HOMEASSISTANT_URL>", HOMEASSISTANT_TOKEN = "<YOUR_HOMEASSISTANT_TOKEN>" }Braucht uv (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
Gemini CLI
gemini mcp add -e "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" -e "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" home-assistant uvx ha-mcp@latestDamit fügst du ihn dem aktuellen Projekt hinzu. Ergänze -s user, um ihn überall zu nutzen.
Jeder Client
Die meisten Clients, die lokale Server starten, akzeptieren diese Form:
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}Zed legt Server in seinen Einstellungen unter context_servers ab, mit denselben Feldern command, args und env.
Braucht uv (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
Einbinden
Zeig Home Assistant (ha-mcp) in einem README oder auf deiner Website. Jede Einbindung verlinkt auf diese Seite, nutzt den Installationsbefehl des Servers und setzt keine Cookies. So funktionieren Einbindungen
Karte, iframe und JSON sind auf Englisch. Häng ?lang=it, fr, de oder es an ihre Adresse an, um eine andere Sprache zu bekommen.
README-Badge
[](https://mcp.tc/i/home-assistant)<a href="https://mcp.tc/i/home-assistant"><img src="https://mcp.tc/i/home-assistant/badge.svg" alt="Home Assistant (ha-mcp) on mcp.tc" height="20"></a>Es folgt dem hellen oder dunklen Modus der Lesenden. Hänge ?theme=light oder ?theme=dark an, um ihn festzulegen, oder ?style=compact, um das Zeichen ohne Schriftzug zu zeigen.
Website-Karte
<script src="https://mcp.tc/w/home-assistant.js" async></script>Die Karte erscheint dort, wo das Tag steht. Füge dem Tag data-theme="dark" oder data-size="compact" hinzu, um sie zu ändern. Die Datei enthält alles, was sie braucht, stellt also keine weiteren Anfragen und setzt keine Cookies.
iframe
<iframe src="https://mcp.tc/embed/home-assistant" title="Home Assistant (ha-mcp) on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Nutze es auf Seiten, die keine Skripte erlauben. Hänge ?theme=light oder ?theme=dark an die Adresse an, um die Farben festzulegen.
JSON
Der Eintrag als Daten für deine eigenen Seiten und Tools: Name, Kurzbeschreibung, Installationsbefehl, Tools und die „Add to“-Links. Jede Website kann ihn lesen (CORS ist offen).
https://mcp.tc/i/home-assistant.jsonKI-Prompt
Füg ihn in einen KI-Coding-Assistenten wie Claude Code oder Cursor ein, und er baut die Karte von Home Assistant (ha-mcp) in deine Website ein.
Füge meiner Website die mcp.tc-Karte für den MCP-Server Home Assistant (ha-mcp) hinzu. Es ist ein einziges statisches Skript: kein Build-Schritt, kein Paket zu installieren, keine Cookies.
Setz dieses Tag dorthin, wo die Karte erscheinen soll. Die Karte erscheint direkt davor:
```html
<script src="https://mcp.tc/w/home-assistant.js" async></script>
```
Um sie woanders zu zeigen, setz dort diesen Platzhalter ein und lade dasselbe Skript nur einmal, zum Beispiel vor `</body>`. Lass den Link darin stehen: Besucher ohne JavaScript sehen ihn.
```html
<div data-mcptc="home-assistant"><a href="https://mcp.tc/i/home-assistant">Home Assistant (ha-mcp) on mcp.tc</a></div>
```
Optionen:
- `data-theme="light"` oder `"dark"` am Tag oder Platzhalter legt die Farben fest. Ohne das Attribut folgt die Karte dem hellen oder dunklen Modus der Besucher.
- `data-size="compact"` ergibt eine kleinere Karte ohne Kurzbeschreibung.
- Die CSS-Variable `--mcptc-max-width` am Platzhalter oder einem Elternelement legt die Breite fest (Standard `520px`).
- `?lang=` in der Skript-URL legt die Sprache der Karte fest: `en`, `it`, `fr`, `de` oder `es`.
Wenn die Website eine Content Security Policy hat, erlaube `script-src https://mcp.tc` und `img-src data:` (das Icon ist eingebettet).
Für ein README oder andere Markdown-Dokumentation nimm stattdessen das Badge:
```markdown
[](https://mcp.tc/i/home-assistant)
```
Referenz: https://mcp.tc/de/embedÄnderungsverlauf
Dieser Server läuft auf deinem Computer, deshalb verfolgen wir sein PyPI-Paket: Jede neue Version erscheint hier, dazu Änderungen seines Betreibers.
Folge Home Assistant (ha-mcp), und wir schicken dir eine E-Mail, wenn sich etwas ändert.
-
Neue Version 9.2.0 (vorher 9.1.2). Von PyPI gelesen.
-
Neue Version 9.1.2 (vorher 9.1.1). Von PyPI gelesen.
-
Neue Version 9.1.1 (vorher 9.1.0). Von PyPI gelesen.
-
Neue Version 9.1.0 (vorher 9.0.0). Von PyPI gelesen.
-
Neue Version 9.0.0 (vorher 8.7.0). Von PyPI gelesen.
-
Neue Version 8.7.0 (vorher 8.6.0). Von PyPI gelesen.
-
Beginn der Beobachtung: Version 8.6.0.
Häufige Fragen
Kann ich mcp.tc/i/home-assistant in meinen MCP-Client einfügen?
Nein. Home Assistant (ha-mcp) läuft auf deinem eigenen Rechner und wird von deinem Client gestartet, hat also keine Webadresse, mit der man sich verbinden könnte. Der Quick-Link ist die Seite zum Teilen; der Installationsbefehl lautet uvx ha-mcp@latest.
Braucht Home Assistant (ha-mcp) einen API-Schlüssel?
Ja. Er liest HOMEASSISTANT_URL und HOMEASSISTANT_TOKEN aus seiner Umgebung, und HOMEASSISTANT_TOKEN ist geheim. Trag den Wert in die Konfiguration deines Clients auf deinem eigenen Rechner ein, nie in eine geteilte Datei.
Ist Home Assistant (ha-mcp) ein Remote- oder ein lokaler Server?
Lokal. Dein Client startet ihn mit uvx ha-mcp@latest als Prozess auf deinem Rechner; dafür brauchst du uv (Python).
Was kann Home Assistant (ha-mcp)?
Du kannst damit Smart-Home-Geräte steuern und Home-Assistant-Services aufrufen, Entity-Zustände abfragen und Automatisierungen und Skripte verwalten.
Welche Clients können ihn nutzen?
Jeder Client, der lokale Server startet: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed und andere. claude.ai und ChatGPT verbinden sich nur mit Remote-Servern.
Verfolgt mcp.tc Änderungen an Home Assistant (ha-mcp)?
Teilweise. Er läuft auf deinem Computer, deshalb verfolgen wir sein PyPI-Paket: Sein Tab Verlauf zeigt jede neue Version und Änderungen seines Betreibers. Folge dem Eintrag, um eine E-Mail zu bekommen, wenn er sich ändert.
Wer hat diese Seite geschrieben?
Der Roboter von mcp.tc hat die öffentlichen Metadaten von Home Assistant (ha-mcp) (seine Paket- und Repository-Seiten) gelesen, und ein KI-Modell hat daraus den Text entworfen. Ein Mensch prüft alles, was die Prüfungen nicht bestätigen können. Der Text kann trotzdem falsch sein; wenn dir ein Fehler auffällt, nutze Eintrag melden auf dieser Seite. Diese Übersetzung hat ein KI-Modell aus dem englischen Text erstellt.
mcp.tc steht in keiner Verbindung zu homeassistant-ai. Diese Seite entstand aus den öffentlichen Metadaten von Home Assistant (ha-mcp), zuletzt geprüft am 3. Okt. 2026, und ein KI-Modell hat die Beschreibung geschrieben, sie kann also Fehler enthalten. Namen und Marken gehören ihren Inhabern. Stimmt etwas nicht? Eintrag melden. Die Übersetzung hat ein KI-Modell aus dem englischen Text erstellt.