Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Bewertungen und Benutzerkonten folgen in einem späteren Schritt.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Home Assistant MCP

von VortitronVersion 0.17.3i★ –iLäuft auf deinem Computer
Name in der Registryio.github.Vortitron/home-assistant-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Home Assistant and ESPHome for coding agents: states, services, automations, dashboards, flashing.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft auf deinem Computer
  • Transport: stdio
  • Kategorie: Entwicklertools
  • Das musst du eintragen: HA_TOKEN, VOMEHOME_TOKEN

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

  • Basischecks: 1 von 1 bestanden
  • Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
  • Das trägst du selbst ein: HA_URL, HA_TOKEN, HA_ALLOW_WRITE, VOMEHOME_TOKEN

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

  • npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "home-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@vortitron/home-assistant-mcp"
      ],
      "env": {
        "HA_URL": "your-value",
        "HA_TOKEN": "your-value",
        "HA_ALLOW_WRITE": "your-value",
        "VOMEHOME_TOKEN": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add home-assistant --env HA_URL=your-value --env HA_TOKEN=your-value --env HA_ALLOW_WRITE=your-value --env VOMEHOME_TOKEN=your-value -- npx -y @vortitron/home-assistant-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "home-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@vortitron/home-assistant-mcp"
      ],
      "env": {
        "HA_URL": "your-value",
        "HA_TOKEN": "your-value",
        "HA_ALLOW_WRITE": "your-value",
        "VOMEHOME_TOKEN": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "home-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vortitron/home-assistant-mcp"
      ],
      "env": {
        "HA_URL": "your-value",
        "HA_TOKEN": "your-value",
        "HA_ALLOW_WRITE": "your-value",
        "VOMEHOME_TOKEN": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

  • HA_URL env
    Your Home Assistant's address, e.g. http://homeassistant.local:8123 (or use VOMEHOME_TOKEN instead)
  • HA_TOKEN geheim env
    A Home Assistant long-lived access token
  • HA_ALLOW_WRITE env
    Set to true to allow service calls and edits; reads only without it
  • VOMEHOME_TOKEN geheim env
    A key from the Vome app's Agent tab, to reach the home through Vome instead of HA_URL and HA_TOKEN

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto Vortitron bestätigt, dem das Repo gehört

  • … Noch nicht geprüft

    Wird noch gepflegt

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • … Noch nicht geprüft

    Hat eine Lizenz

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Entwicklertoolsi

  • Mehr Sterne als 0 % der anderen 4906 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 92 % der anderen 4906 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 4906 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Home Assistant MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: HA_TOKEN, VOMEHOME_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.17.3) kam vor 3 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: GitHub, Desktop Commander, Cloudflare MCP

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

GitHub

von github

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

Computer oder Cloud★ 34.245MITAktualisiert vor 4 Tagen
Installieren

Desktop Commander

von wonderwhy-er

MCP server for terminal commands, file operations, and process management

Läuft auf deinem Computer★ 10.225MITAktualisiert vor 16 Tagen
Installieren

Cloudflare MCP

von cloudflare

Cloudflare MCP servers

Läuft in der Cloud★ 4.446Apache-2.0Aktualisiert vor 14 Monaten
Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

home-assistant-mcp

A Model Context Protocol (MCP) server that lets coding agents — Cursor, VS Code (Copilot), Claude Desktop and anything else that speaks MCP — talk directly to Home Assistant and (optionally) the ESPHome dashboard.

Instead of copy-pasting entity ids, YAML and current values into your agent, the agent can discover entities, read live state, render templates, call services and edit automations itself — and iterate until the code actually works.

In Claude Code, four side panes show what Claude is doing to your home as it happens: the automation it is working on, the ESPHome device it is building, the home's health score and a dashboard that works. One command installs all four (below).

Part of the Vome family and an open-source companion to

VomeHome (managed Home Assistant). It is useful stand-alone for any Home

Assistant user.


Why

A typical "change an automation" loop today looks like: you tell the agent which entities exist, paste their current values, paste the YAML, apply the change, then manually check whether it worked. With this server the agent does all of that:

  • See — list entities/areas/devices, read exact states and attributes, pull history and the logbook.
  • Experiment — render Jinja templates against live state, check configuration, read the error log.
  • Change — call services, create/update/delete/trigger automations, and (for ESPHome) edit, validate, compile and flash device firmware.

All write operations are off by default and gated behind an explicit safety policy (see Safety).


Tools

Home Assistant — read
ToolDescription
ha_get_configCore config: version, location, time zone, loaded components.
ha_list_entitiesList entities (filter by domain, free-text search, area).
ha_get_stateFull state + attributes for one or more entities.
ha_get_historyHistorical state changes over a time window. Given only a start time, it runs up to now (Home Assistant alone stops 24 hours after the start); ha_get_logbook does the same.
ha_list_servicesAvailable services (and their fields for a given domain).
ha_list_areasAreas (rooms/zones).
ha_list_devicesDevice registry (filter by area / search).
ha_get_entity_registryRegistry metadata: platform, area, device, disabled/hidden.
ha_render_templateRender a Jinja2 template against live state.
ha_list_helpersList stored helpers (input_boolean, input_number, counter, timer, …).
ha_list_automationsAutomations with entity_id, unique id, state, last-triggered.
ha_get_automationFull automation config (triggers/conditions/actions) for an automation made in the editor. One written in a YAML package or included file is named as such, with what to search for to find its file.
ha_check_configValidate the configuration (Check configuration).
ha_wait_until_runningWait (up to 120 s) for Home Assistant to finish restarting, checking its core state every 5 s. While it restarts, the other tools say "Home Assistant is restarting (core state: …)" or "not answering — it may be restarting" instead of a raw 502, nginx 404 or WebSocket error. When the home is a CHAP pair's main and its standby is running the home (failover), they say that instead, name the standby and how to reach it (instance_id on the call, or vomehome_use_instance); the CHAP status is asked once per half minute at most, and only for restart-shaped failures.
ha_get_system_logDeduplicated, structured errors — level, logger, source, count, first/last seen. Start here.
ha_get_error_logTail of the raw Home Assistant error log.
ha_get_supervisor_logAdd-on / Core / Supervisor / host logs (HAOS or Supervised).
ha_list_media_files / ha_read_media_fileRead-only look into /media: a saved camera snapshot comes back as an image (needs ha:files, and Vome add-on 0.3.66 / integration 0.9.51 on the home).
ha_camera_imageA camera's current still, as an image the agent can see. Via VomeHome the key needs Cameras ticked.
ha_camera_frameA camera still decoded and shrunk to a small grid of RGB pixels, for clients that draw pictures in text.
ha_view_snapshotEverything a dashboard view shows in one call: states, rendered templates, history in few points, camera frames. For dashboard clients.
ha_watch_statesWait for state changes instead of polling: the home's Vome component sends them as they happen (through VomeHome). Where no component is connected (a hosted home without the Vome add-on, a direct connection) it reads the states every ~3 s for the same wait and answers in the same shape with mode: "polling"; a 401/403 is never papered over.
ha_get_logbookHuman-readable logbook entries, filtered by entity_id, contains (message, name or entity_id), name (e.g. Vome) and domain. At most limit (default 500) come back, the newest, with count_before_limit, truncated and older_entries_end_time to read further back. A window longer than a day is read a day at a time, newest first, stopping as soon as limit entries match (at most 31 days per call), so Home Assistant is never asked for more than 24 hours at once.
ha_get_energy_prefsThe Energy dashboard's setup (grid, solar, battery, gas, water, tracked devices) with the dashboard's own validation.
ha_list_tracesRecent automation/script runs and how each one stopped.
ha_get_traceStep-by-step detail for one run, with failed_at naming the blocking step.
Home Assistant — write (write-gated)

Write-gating depends on the mode. In direct mode the MCP is the only guard,

so these refuse until HA_ALLOW_WRITE=true. In brokered mode your VomeHome

API key carries the per-instance ha:write / ha:config scopes and the server

enforces them, so the client flags are optional local-only restrictions.

ToolDescription
ha_call_serviceCall any service (turn_on, set_temperature, …). A service that can return a response (shell_command's stdout/stderr/returncode, script, weather.get_forecasts …) is asked for it, and it comes back as service_response.
ha_speech_to_textRun a WAV (16-bit PCM, at most 30 s) through one of the home's speech-to-text engines (stt.*) and get back the words it heard, to test an assistant's hearing without speaking to a device. audio_path reads a local file (npx servers only); audio_base64 sends the bytes (the hosted MCP). Language defaults to the home's own. Engines want 16 kHz mono (ffmpeg -i in.wav -ar 16000 -ac 1 -sample_fmt s16 out.wav). A write because some engines (Vome Hearing, cloud ones) charge per request: needs HA_ALLOW_WRITE / ha:write; not for external homes through VomeHome.
ha_clear_system_logEmpty the structured error store (only needs HA_ALLOW_WRITE).
ha_set_log_levelChange logging for one integration at runtime (only needs HA_ALLOW_WRITE).
ha_set_automationCreate or update an automation (also needs HA_ALLOW_CONFIG_WRITE).
ha_set_helperCreate or update a helper — no configuration.yaml, no restart.
ha_read_config_fileRead a file under the config directory — text by default, or encoding: 'base64' for a binary asset (needs ha:files).
ha_write_config_fileReplace a file under the config directory — text by default, or encoding: 'base64' for a binary asset; checks the config and restores the file if it fails (needs ha:files).
ha_upload_fileCopy a file already on disk (a web page, an image, a package) into the config directory: read from the MCP server's own filesystem, sent as text or base64 as it needs, at most 2 MiB, written and checked like ha_write_config_file. Local (npx) servers only — the hosted MCP can't see your files and answers with the equivalent curl upload (needs ha:files).
ha_delete_config_fileDelete one file under the config directory. Never a directory, and never configuration.yaml, secrets.yaml or Home Assistant's database. Names its target home like a write (needs ha:files, and Vome add-on 0.3.55 / integration 0.9.39 on the home).
ha_edit_config_fileChange part of a text file in place: exact find-and-replace edits that must each match once, then the same check-and-restore as a write. For a three-line change to a large file (needs ha:files).
ha_list_config_filesList a directory under the config directory, folders first: glob filters by name (*.yaml) or path (**/*.html), offset/limit page (default 200), and the reply gives total_entries, total_bytes (this folder's own files, not subfolders) and truncated when the home stopped at its 500-entry cap (needs ha:files).
ha_move_config_fileMove or rename one file under the config directory, creating folders on the way; never overwrites unless asked. Names its target home like a write (needs ha:files, and Vome add-on 0.3.66 / integration 0.9.51).
ha_delete_helperDelete a stored helper. Refuses when the id looks shared with a configuration.yaml helper, because Home Assistant would take that entity down with it.
ha_delete_automationDelete an automation (also needs HA_ALLOW_CONFIG_WRITE).
ha_get_script / ha_set_script / ha_delete_scriptScripts by id, the same way as automations: put a step several automations share in one script. Writes need HA_ALLOW_CONFIG_WRITE.
ha_update_entityRename, re-id, move, re-icon, disable or hide an entity in the registry (needs HA_ALLOW_CONFIG_WRITE).
ha_update_deviceRename a device, move it to an area, disable it or set its labels (needs HA_ALLOW_CONFIG_WRITE).
ha_expose_entitiesList or change what Assist, Alexa and Google Assistant can see and control; listing needs only read (changing needs HA_ALLOW_CONFIG_WRITE).
ha_set_energy_prefsChange the Energy dashboard's setup; each list passed replaces that list whole, then it is validated (needs HA_ALLOW_CONFIG_WRITE).
ha_get_statisticsRead long-term statistics (what the Energy dashboard draws) per 5 minutes to month; largest_changes lists the biggest buckets, like the Outliers button.
ha_adjust_statisticCorrect one 5-minute bucket of a statistic, by new value or by adjustment, as Developer Tools → Statistics does (needs HA_ALLOW_CONFIG_WRITE).
ha_remove_entityRemove an orphaned registry entry (needs HA_ALLOW_CONFIG_WRITE).
ha_matter_reinterviewThe Matter device page's Re-interview, for a device whose endpoints changed after a firmware update (needs HA_ALLOW_CONFIG_WRITE).
ha_trigger_automationManually run an automation now.
ha_reload_automationsReload automations without restarting.
Lovelace dashboards (direct HA or VomeHome brokered)
ToolWhat it does
ha_list_dashboardsList dashboards (url_path, title, mode, sidebar).
ha_get_dashboardRead one dashboard's full config (views, cards, …).
ha_save_dashboardSave/replace a dashboard config (needs HA_ALLOW_CONFIG_WRITE).
ha_create_dashboardRegister a new storage-mode dashboard (needs HA_ALLOW_CONFIG_WRITE).

| ha_update_dashboard | Change a dashboard's title, icon, sidebar

Nur der Anfang wird gezeigt; den Rest findest du im Repo

PopNx fragen