Zum Inhalt

NFC-Tags in Home Assistant einrichten: Szenen sicher per Smartphone starten

Veröffentlicht am 9. Oktober 2026 · Geschätzte Lesezeit: 9 Minuten

Ein NFC-Tag ist ein kleiner Aufkleber oder eine Karte mit Antenne und Speicher, den das Smartphone beim Draufhalten kurz mit Energie versorgt – er braucht weder Batterie noch eine zusätzliche Bridge. Nachdem du den Tag einmal mit der Companion App beschrieben hast, löst jeder Scan in Home Assistant genau die Automation aus, die du ihm zugeordnet hast: zum Beispiel eine „Gute-Nacht“-Szene starten, eine Testlampe ausschalten oder eine Benachrichtigung senden. Die offiziellen Companion-Apps unterstützen NFC-Tags direkt, die Tag-Integration gehört zum Standardumfang von Home Assistant.[1][2]

Du brauchst für den ersten Tag inklusive Beschreiben, Automation anlegen und sicherem Funktionstest etwa 20 bis 35 Minuten. Wichtig: Beginne mit einer harmlosen Aktion und baue erst nach erfolgreichem Test weitere Schritte aus.

Voraussetzungen

  • Eine laufende Home-Assistant-Installation mit Administratorzugang
  • Die offizielle Companion App auf Android oder iOS, angemeldet an genau dieser Instanz
  • Ein Smartphone mit aktiviertem NFC und mindestens ein NFC-Tag (Aufkleber oder Karte)
  • Eine vorhandene harmlose Szene oder eine unkritische Lampe zum Testen
  • Ein aktuelles vollständiges Home-Assistant-Backup

1. Backup und sicheren Rückweg vorbereiten

Öffne Einstellungen → System → Backups, erstelle ein vollständiges Backup und bewahre nach Möglichkeit eine zusätzliche Kopie außerhalb des Home-Assistant-Systems auf.

Notiere dir außerdem den Namen des neuen Tags und der neuen Automation. Der einfache Rückweg besteht darin, zuerst die Automation zu deaktivieren und zu löschen und danach den Tag in der Tag-Verwaltung zu entfernen. Denke daran: Das Löschen des Eintrags in Home Assistant löscht nicht automatisch den Inhalt, der bereits auf dem physischen Tag gespeichert ist.[1]

2. Smartphone und Tag prüfen

Aktiviere NFC am Smartphone, meist unter Verbindungen oder Drahtlos & Netzwerke in den Systemeinstellungen. Die Companion App muss mit der richtigen Home-Assistant-Instanz verbunden sein; kontrolliere das in den App-Einstellungen, bevor du weitermachst.[1][2]

Nicht jeder Tag ist gleich: Einige NFC-Tags sind schreibgeschützt und lassen sich nicht als Home-Assistant-Tag verwenden, andere erlauben nur ein einziges Beschreiben und sind danach schreibgeschützt.[2] Teste deshalb einen frischen Tag zuerst harmlos. Eine dicke oder metallhaltige Handyhülle sowie das Halten direkt auf eine Metallfläche können das Lesen stören; dort helfen Abstand oder spezielle On-Metal-Tags.

Auf iOS hängt das Lesen im Hintergrund vom Gerät ab: Nur iPhone XS, XR und iPhone 11 oder neuer unterstützen das Hintergrundlesen von NFC-Tags.[1] Das konkrete Verhalten prüfst du am Ende mit deinem eigenen Gerät.[1]

3. Tag in Home Assistant anlegen

Home Assistant verwaltet Tags in einem eigenen Bereich. Öffne Einstellungen → Tags (englisch: Settings → Tags) und lege einen neuen Tag an.[3] Vergib einen eindeutigen Namen in der Tag-Verwaltung, zum Beispiel:[1]

Nachttisch – Gute Nacht

Home Assistant erzeugt beim Anlegen automatisch eine Tag-ID und speichert den neuen Tag in der Tag-Verwaltung.[1][2] Diese ID erkennst du später in den Automationseinstellungen wieder. Sie entspricht dem Wert, den die App später in die URL https://www.home-assistant.io/tag/<tag-id> einsetzt. Ersetze <tag-id> in dieser URL durch die ID deines Tags.[2]

Für jeden angelegten Tag legt Home Assistant automatisch eine tag-Entität an, deren Zustand den Zeitpunkt des letzten Scans anzeigt.[1] Du kannst sie zum Beispiel auf einem Dashboard anzeigen oder in Automationen verwenden.[1]

4. Tag mit der Companion App beschreiben

Öffne in der Companion App Einstellungen → Companion App → NFC-Karten → Schreiben (englisch: Settings → Companion App → NFC Cards → Write) und wähle den in Schritt 3 angelegten Tag aus.[2] Halte den NFC-Tag anschließend kurz an das Handy; die App schreibt die Tag-URL auf den Tag.[2]

Deine App kann den Tag außerdem direkt aus der Tag-Übersicht heraus beschreiben; die Tag-Oberfläche der App bietet das Schreiben auf einen Tag an.[1] Als Inhalt wird eine normale URL gespeichert: Sobald das Handy sie liest, löst die App das Ereignis tag_scanned in deiner Home-Assistant-Instanz aus.[2] Auf Android genügt dafür das Vorbehalten des Tags. Auf iOS erscheint je nach Gerät und Version zunächst eine Benachrichtigung, die beim Antippen die App öffnet und dann das Ereignis auslöst.[2]

Die Praxisquelle berichtet aus Erfahrung, dass bei iOS das Entsperren des Telefons für das Lesen nicht nötig ist, während bei Android das Gerät entsperrt sein muss – prüfe das mit deinem eigenen Gerät, weil es von Modell und Version abhängt.[7] Die offiziellen Videos Writing a tag (iOS) und Writing a tag (Android) vom Home-Assistant-Kanal zeigen das Beschreiben für beide Systeme.[8][9]

5. Erste harmlose Automation anlegen

Öffne Einstellungen → Automatisierungen & Szenen und wähle Automation erstellen. Wähle als Auslöser den Trigger Tag und darin deinen Tag aus Schritt 3.[3] Als Aktion wählst du für den ersten Test besser eine unkritische Lampe (Lampe ausschalten) statt einer Szene; eine vorhandene Szene (Szene aktivieren) funktioniert genauso. Speichere die Automation und aktiviere sie.[3]

Du kannst die Automation auch direkt vom Tag aus anlegen: Öffne dazu Einstellungen → Tags, wähle im Menü des Tags Automation erstellen.[3]

Keine sicherheitskritischen Aktionen an Tags hängen

Ein NFC-Tag wird von jedem ausgelöst, der physisch an den Tag oder an ein berechtigtes Smartphone herankommt. Verwende Tags deshalb nicht für Alarmanlagen, Türschlösser, Garagentore, Herd oder Bewässerung. Die Praxisquelle beschreibt Tür- und Schlossaktionen – diese Anleitung baut solche Szenarien bewusst nicht nach.[7]

6. YAML-Variante mit Erklärungen

Falls du lieber mit YAML arbeitest oder die Automation in der Datei automations.yaml pflegst, zeigt dieser Block die Struktur, die auch der visuelle Editor für den Tag-Trigger erzeugt:[3]

- id: nfc_gute_nacht_szene
  alias: "NFC: Gute-Nacht-Szene"
  description: "Aktiviert beim Scannen des NFC-Tags eine vorhandene Szene."
  mode: single
  triggers:
    - trigger: tag
      tag_id: "<TAG_ID>"
  conditions: []
  actions:
    - action: scene.turn_on
      target:
        entity_id: scene.<SZENEN_ID>
  • - id: ist eine frei gewählte, eindeutige Kennung; alias und description sind Namen beziehungsweise Kurzbeschreibung der Automation.
  • mode: single ist der Standardmodus: Die Automation startet keinen zweiten Lauf, solange der erste noch läuft, und protokolliert eine Warnung.[10]
  • triggers enthält mit - trigger: tag den Tag-Trigger, der auf tag_scanned-Ereignisse lauscht; tag_id ist dabei ein Pflichtfeld.[3]
  • conditions: [] bedeutet: keine Bedingungen, die Aktion läuft bei jedem Scan.
  • actions aktiviert mit scene.turn_on eine Szene. Eine Szene speichert den Zustand einer Gruppe von Entitäten und stellt ihn mit einem Schritt wieder her.[11]

Ersetze <TAG_ID> durch die ID deines Tags aus Schritt 3.[3] Ersetze <SZENEN_ID> durch die ID deiner Szene, zum Beispiel gute_nacht, sodass aus dem Platzhalter scene.gute_nacht wird.

Noch risikoärmer ist der erste Test mit einer einzelnen Lampe:

- id: nfc_testlampe_aus
  alias: "NFC: Testlampe ausschalten"
  description: "Schaltet beim Scannen des NFC-Tags eine Testlampe aus."
  mode: single
  triggers:
    - trigger: tag
      tag_id: "<TAG_ID>"
  conditions: []
  actions:
    - action: light.turn_off
      target:
        entity_id: light.<TESTLAMPE>

Ersetze <TAG_ID> wie im ersten Block. Ersetze <TESTLAMPE> durch die Entity-ID deiner unkritischen Lampe, zum Beispiel light.nachttisch. Die Aktionssyntax entspricht dem offiziellen Beispiel für den Tag-Trigger.[3]

7. Funktion mit echtem Scan prüfen

Halte das Smartphone an den beschriebenen Tag und kontrolliere:

  1. Es reagiert ausschließlich die vorgesehene Szene beziehungsweise Testlampe.
  2. In Einstellungen → Tags beziehungsweise in der tag-Entität ist der Zeitpunkt des letzten Scans aktualisiert.[1]
  3. In Entwicklerwerkzeuge → Ereignisse (englisch: Settings → Tools → Events) erscheint beim Lauschen auf tag_scanned ein Ereignis mit tag_id, name und device_id.[1][3]
  4. In der Automation zeigt die Spur (englisch: Trace), dass Trigger und Aktion sauber durchgelaufen sind. Öffne bei Problemen zuerst die Spur.[6]

Wichtig: Aktionen ausführen (englisch: Run actions) ist kein vollständiger NFC-Test, weil dabei der echte Tag-Trigger und dessen Triggerdaten fehlen. Eine deaktivierte Automation reagiert nicht auf den Scan, lässt sich aber weiterhin manuell ausführen – genau das nutzt du in Schritt 10 für den Rückweg-Test.[6]

8. Mehrere Tags und bestimmte Geräte

Möchtest du mehrere Tags mit einer Automation bedienen, kannst du im Trigger mehrere Tag-IDs angeben:[3]

    - trigger: tag
      tag_id:
        - "<TAG_ID>"
        - "<TAG_ZWEI>"

Ersetze <TAG_ID> und <TAG_ZWEI> durch die IDs der beiden Tags. Soll nur ein bestimmtes Smartphone oder ein bestimmter Scanner den Tag auslösen, ergänzt du device_id.[3]

    - trigger: tag
      tag_id: "<TAG_ID>"
      device_id: "<GERAETE_ID>"

Ersetze <GERAETE_ID> durch die Geräte-ID aus dem tag_scanned-Ereignis (siehe Schritt 7), die angibt, welches Gerät den Tag zuletzt gescannt hat.[1] Im visuellen Editor wählst du den Tag direkt aus; die Einschränkung auf ein Gerät fügst du in YAML hinzu.[3]

Willst du die Rohdaten des Ereignisses auswerten, lauscht ein event-Trigger auf tag_scanned und nutzt Werte wie trigger.event.data.tag_id oder trigger.event.data.device_id – so zeigt es das offizielle Beispiel in der Tag-Dokumentation.[1] Automationen unterstützen Templating in gleicher Weise wie Skripte und stellen dafür die Trigger-Variable bereit.[5] Für den einfachen Fall bleibt der Tag-Trigger mit tag_id die klarste Lösung.[3]

9. Typische Fehler beheben

  • NFC ist deaktiviert: Prüfe die Systemeinstellungen des Smartphones.
  • Falsche Instanz verbunden: Die Companion App muss an genau die Home-Assistant-Instanz angemeldet sein, in der der Tag angelegt wurde.[1][2]
  • Tag schreibgeschützt oder nur einmal beschreibbar: Solche Tags lassen sich gar nicht beziehungsweise nur einmal für Home Assistant beschreiben.[2]
  • Kein Scan erkannt: Entferne dicke oder metallhaltige Hüllen und halte den Tag nicht direkt auf eine Metallfläche. Bei iOS beachte die Geräteeinschränkung für das Hintergrundlesen.[1]
  • Falsche tag_id oder Entity-ID: Vergleiche die Werte in Trigger und Aktionen mit deinen Einträgen aus Schritt 3 und 6.[3]
  • Automation deaktiviert: Eine ausgeschaltete Automation reagiert nicht auf den Scan.[6]
  • Szene fehlt oder ist leer: Kontrolliere, dass die Szene noch existiert und die gewünschten Leuchten enthält.[11]
  • „Aktionen ausführen“ statt echtem Scan: Dabei fehlen Trigger und Triggerdaten; scanne den physischen Tag und öffne die Spur.[6]
  • Menünamen weichen ab: Je nach Systemsprache sowie App- und Home-Assistant-Version heißen einzelne Menüpunkte anders. Die Praxisquelle von 2023 verwendet ältere Oberflächenbegriffe und dient nur als ergänzende Ideenquelle.[7]

10. Rückweg durchführen

  1. Deaktiviere die betroffene Automation.[6]
  2. Scanne den Tag erneut: Es darf keine Aktion mehr ausgelöst werden.[6]
  3. Lösche die Automation oder stelle ihren vorherigen Stand wieder her.
  4. Entferne den nicht mehr benötigten Tag in Einstellungen → Tags.[1]
  5. Überschreibe bei einem beschreibbaren Tag dessen Inhalt erneut oder entferne den Aufkleber beziehungsweise die Karte physisch – das Löschen des Eintrags in Home Assistant entfernt den Inhalt auf dem Tag nicht.[1][2]

Schütze deine Home-Assistant-Instanz und dein Smartphone unabhängig von den Tags mit einem langen Passwort beziehungsweise einer starken Gerätesperre und aktuellen Updates.

Grundlage dieser Anleitung sind die offizielle Dokumentation der Tag-Integration, der Beitrag der Companion-Dokumentation zu NFC- und QR-Tags sowie die Trigger-Referenz zum Tag-Trigger, geprüft am 9. Oktober 2026. Als Praxisquelle dient der Bericht „NFC-Tags in Home Assistant verwenden“ (2023) mit den offiziellen Videos Writing a tag (iOS) und Writing a tag (Android).

Sources

[1] https://www.home-assistant.io/integrations/tag — Home Assistant: Tags [2] https://companion.home-assistant.io/docs/integrations/universal-links — Home Assistant Companion: NFC Tags & QR Codes [3] https://www.home-assistant.io/triggers/tag — Home Assistant: Tag trigger [5] https://www.home-assistant.io/docs/automation/templating — Home Assistant: Automation templating [6] https://www.home-assistant.io/docs/automation/troubleshooting — Home Assistant: Automation troubleshooting [7] https://www.bujarra.com/uso-de-nfc-tags-en-home-assistant/?lang=de — Bujarra: NFC-Tags in Home Assistant verwenden [8] https://www.youtube.com/watch?v=Xc120lClUgA — YouTube (Home Assistant): Writing a tag (iOS) [9] https://www.youtube.com/watch?v=xE7wm1bxRLs — YouTube (Home Assistant): Writing a tag (Android) [10] https://www.home-assistant.io/docs/automation/modes — Home Assistant: Automation modes [11] https://www.home-assistant.io/integrations/scene — Home Assistant: Scenes

Fertig

Du kannst jetzt NFC-Tags mit der Companion App beschreiben, in Home Assistant verwalten und mit einer harmlosen Automation sicher testen.[1][2][3] Die Funktionsprüfung ist bestanden, wenn das Scannen des Tags ausschließlich die vorgesehene Aktion auslöst, das tag_scanned-Ereignis in den Entwicklerwerkzeugen tag_id, name und device_id enthält,[1] die Spur Trigger und Aktion ohne Fehler zeigt[6] und eine deaktivierte Automation beim erneuten Scannen nichts mehr tut.