Tesla mit Home Assistant verbinden: Schritt-für-Schritt mit myTeslaMate

Dein Tesla liefert eine Menge Daten: Ladezustand, Reichweite, Standort, Innentemperatur, Reifendruck. Alles in der Tesla-App verstreut. Mit Home Assistant holst du dir diese Daten ins Smart Home, baust ein Dashboard und kannst Automationen darauf aufbauen. Klima vorheizen wenn der Wecker klingelt, Sentry beim Verlassen aktivieren, Push aufs Handy wenn die Ladung fertig ist.

Dieser Guide zeigt den kompletten Weg: von null bis zum fertigen Tesla-Dashboard in Home Assistant. myTeslaMate macht das Setup deutlich einfacher als früher, weil es drei Dinge auf einmal übernimmt: Public Key hosten, Tokens generieren und den Command-Proxy bereitstellen.

Update Juni 2026: Dieser Guide wurde komplett überarbeitet. Der Weg über FleetKey.cc ist nicht mehr nötig. myTeslaMate übernimmt das Key-Hosting. Das Video zeigt noch den alten Weg über FleetKey.cc. Die Schritte hier im Blog-Post sind aktuell.

Was du brauchst

• Home Assistant (aktuelle Version)
• Tesla Model 3/Y/S/X (fast jeder Tesla funktioniert, China-Region ist nicht unterstützt)
• myTeslaMate Account mit aktiver Subscription
• HACS in Home Assistant installiert (für die Vehicle Status Card)
• Einen Computer mit Terminal (Mac/Linux) oder PowerShell (Windows) für die Token-Generierung

Schritt 1: myTeslaMate Account erstellen

Öffne app.myteslamate.com und erstelle einen Account. Du brauchst eine aktive Subscription. Damit bekommst du:

• Eine eigene TeslaMate-Instanz (Fahrzeugdaten, Lade-Historie, Grafana)
• API-Zugang mit Public-Key-Hosting (ersetzt FleetKey.cc)
• Den Command-Proxy (für signierte Fahrzeug-Befehle)

Schritt 2: Tesla Developer Account aktivieren

1. Öffne developer.tesla.com und logge dich mit deinem normalen Tesla-Account ein (derselbe wie in der Tesla-App).
2. Developer-Zugang aktivieren. Das ist einmalig und kostenlos.
3. Klicke auf "New Request", um eine neue API-App anzulegen.

Schritt 3: Tesla API-App anlegen

Jetzt brauchst du zwei Browser-Tabs gleichzeitig, weil du Daten zwischen Tesla und myTeslaMate hin- und herkopierst.

Tab 1: Tesla Developer Portal

1. Name: Frei wählbar, z.B. "Home Assistant" oder "Mein Smart Home".
2. Description / Purpose: Kurz beschreiben, z.B. "Smart Home Integration". Tesla prüft das nicht im Detail.
3. Grant Type: Wähle "Authorization Code and Machine-to-Machine".

Tab 2: myTeslaMate

4. Öffne app.myteslamate.com/tesla in einem neuen Tab. Dort zeigt dir myTeslaMate zwei URLs an: eine Allowed Origin URL und eine oder mehrere Redirect URIs.
5. Kopiere diese URLs in die passenden Felder im Tesla-Formular: Allowed Origin URL ins Feld "Allowed Origin", Redirect URI(s) ins Feld "Allowed Redirect URI(s)". Das Feld "Allowed Returned URL(s)" leer lassen. Falls du auch Home Assistant Cloud (my.home-assistant.io) nutzt, nimm die zusätzliche Redirect-URI mit.
6. API-Scopes: Aktiviere alle verfügbaren Scopes. Du brauchst mindestens "Vehicle Information", "Vehicle Commands" und "Vehicle Location". Am einfachsten: alle anhaken.
7. Keine Zahlungsdaten eingeben. Tesla fragt danach, aber du brauchst sie für den Anfang nicht. Die ersten 10 USD pro Monat sind kostenlos.
8. App erstellen.

Tesla zeigt dir jetzt Client ID und Client Secret. Beide sofort kopieren und sicher ablegen (Passwort-Manager). Das Client Secret wird nur einmal angezeigt. Wenn du es verlierst, musst du eine neue App anlegen. Du brauchst beides gleich mehrfach.

Stolperfalle: Die Bezeichnungen im Tesla Developer Portal ändern sich gelegentlich. Wenn ein Feld etwas anders heißt als hier beschrieben, lass dich nicht irritieren. Die Logik bleibt gleich.

Schritt 4: App bei myTeslaMate registrieren und Tokens generieren

Zurück auf app.myteslamate.com/tesla:

1. Klicke auf "Register my application" und trage deine Client ID ein. Damit weiß myTeslaMate, welche Tesla-App zu deinem Account gehört.

2. Auf derselben Seite findest du einen Terminal-Befehl, der für dein Betriebssystem vorbereitet ist:

   • Mac/Linux: Terminal öffnen, Befehl einfügen, Enter drücken.
   • Windows: PowerShell öffnen (nicht CMD), Befehl einfügen, Enter drücken.

3. Das Script läuft komplett lokal auf deinem Rechner. myTeslaMate sieht deine Tesla-Zugangsdaten nicht. Alle Anfragen gehen direkt von deinem Computer an die Tesla API.

4. Das Script zeigt dir einen Login-Link. Klicke darauf, es öffnet sich ein Browser-Fenster.

5. Bei Tesla einloggen und die angeforderten Berechtigungen autorisieren. Klicke auf "Select All" und dann "Allow".

6. Tesla zeigt dir einen Code (grün hinterlegt). Diesen Code kopieren.

7. Zurück ins Terminal wechseln und den Code einfügen. Enter drücken.

8. Das Script gibt dir jetzt Access Token und Refresh Token aus. Beide sichern (Passwort-Manager).

Du hast jetzt vier Werte, die du brauchst:

• Client ID (aus Schritt 3, Tesla Developer Portal)
• Client Secret (aus Schritt 3, Tesla Developer Portal)
• Access Token (aus dem Script)
• Refresh Token (aus dem Script)

Access Token und Refresh Token brauchst du für externe Tools wie EVCC (PV-Überschussladen) oder direkte API-Calls über myTeslaMate. Für die Home Assistant Integration im nächsten Schritt brauchst du nur Client ID und Client Secret. HA holt sich über den OAuth-Flow eigene Tokens. Trotzdem alle vier Werte jetzt sichern, damit du das Script nicht nochmal ausführen musst.

Schritt 5: Tesla Fleet Integration in Home Assistant einrichten

Ja, du musst dich hier nochmal bei Tesla einloggen. Das ist kein Fehler. Die Tokens aus Schritt 4 sind für EVCC und myTeslaMate. Dieser OAuth-Flow verbindet Tesla direkt mit deiner Home Assistant Instanz.

Jetzt geht es in Home Assistant:

1. Einstellungen → Geräte & Dienste → Integration hinzufügen
2. Suche nach "Tesla Fleet". Wichtig: Es muss "Tesla Fleet" sein, nicht einfach nur "Tesla". Das sind zwei verschiedene Integrationen.
3. Client ID und Client Secret eingeben (aus Schritt 3).
4. Es öffnet sich ein Browser-Fenster für den OAuth-Flow. Mit deinem Tesla-Account einloggen.
5. Bei der Scope-Auswahl auf "Select All" klicken und dann "Allow".
6. Bestätige das Linking deines Accounts mit Home Assistant.
7. Die Integration fragt nach einer Domain. Trage hier deine persönliche myTeslaMate-Subdomain ein: app-xxxxx.myteslamate.com. Die genaue Subdomain findest du in deinem myTeslaMate-Dashboard unter app.myteslamate.com/tesla.
8. Die Integration prüft, ob dein Public Key unter der Domain erreichbar ist. Den musst du nicht selbst hosten. myTeslaMate hostet den Public Key für dich auf deiner Subdomain. Wenn die Integration die Domain akzeptiert, ist dieser Schritt automatisch erledigt.

Private Key einrichten:

Ohne Private Key kann Home Assistant zwar Daten lesen, aber keine Befehle an dein Auto senden. myTeslaMate stellt dir den Private Key zum Download bereit:

1. In myTeslaMate den Private Key herunterladen (Button auf der Tesla-Seite in deinem Dashboard).
2. Die Datei in Home Assistant ablegen unter dem Pfad:

/config/tesla-fleet.key

3. Der Private Key ist eine Binärdatei. Die File Editor App in HA kann nur Textdateien bearbeiten, keine Dateien hochladen. Zum Hochladen brauchst du entweder einen Samba-Share (App "Samba share" im App Store installieren, dann über deinen Dateimanager auf \\homeassistant\config\ zugreifen) oder die SSH-App ("Advanced SSH & Web Terminal" im App Store). Alternativ: Falls du die File Editor App nutzt, erstelle eine neue Datei unter /config/tesla-fleet.key und füge den Inhalt des Keys als Text ein (den Key mit einem Texteditor öffnen, Inhalt kopieren, in HA einfügen).

Hinweis zum Dateinamen: Die HA-Dokumentation nennt den Pfad tesla_fleet.key (mit Unterstrich), myTeslaMate liefert die Datei als tesla-fleet.key (mit Bindestrich). Wenn Fahrzeug-Befehle nicht funktionieren, probiere den jeweils anderen Dateinamen.

Schritt 6: Virtual Key am Auto pairen

Der Virtual Key autorisiert deine API-App auf deinem konkreten Fahrzeug. Ohne Virtual Key kann Home Assistant keine Befehle senden (Klima, Sentry, Schloss, Wecken).

1. In myTeslaMate auf "Install API on vehicle" klicken.
2. Es erscheint ein QR-Code. Diesen mit der Tesla-App auf deinem Handy scannen.
3. Die Tesla-App zeigt eine Bestätigungsanfrage. Bestätigen.
4. Jetzt zum Auto gehen und dort am Bildschirm bestätigen. Das Auto muss wach und erreichbar sein.

Falls das Auto im Tiefschlaf ist und nicht reagiert: In der Tesla-App auf "Wecken" tippen, kurz warten, dann nochmal versuchen. Der Pairing-Vorgang erfordert Bluetooth-Reichweite zum Auto.

Schritt 7: Entities prüfen

Es kann ein paar Minuten dauern, bis alle Entities erscheinen. Falls nach 5 Minuten nichts da ist: Home Assistant neu starten (Einstellungen → System → Neustart). Das Auto muss wach sein, damit HA Daten abrufen kann.

Gehe zu Entwicklerwerkzeuge → Zustände (das Werkzeug-Icon in der linken Sidebar) und filtere nach dem Namen deines Autos. Bei mir heißt der Tesla "Auto McCarface", also filtere ich nach auto_mccarface. Bei dir steht dort z.B. model_y oder model_3, je nachdem wie dein Auto in HA angelegt wurde.

Du solltest jetzt Entities sehen. Hier die wichtigsten:

Entities MIT Auto-Slug im Namen:

Entities OHNE Auto-Slug im Namen (haben trotzdem den Friendly Name deines Autos):

Warum manche Entities den Slug haben und andere nicht: Tesla Fleet legt verschiedene Domains unterschiedlich an. Das ist normal, kein Fehler.

Wichtig: Diese Entity-Namen gelten bei deutscher HA-Sprache. Wenn dein Home Assistant auf Englisch läuft, heißen die Entities anders (z.B. switch.sentry_mode statt switch.wachter_modus). Filtere im Zweifelsfall einfach nach deinem Auto-Slug in den Entwicklerwerkzeugen.

Deaktivierte Entities: Manche Entities sind standardmäßig deaktiviert (z.B. Sitzheizung, Lenkradheizung). Um sie zu aktivieren: Gerät öffnen → Entity anklicken → Zahnrad → "Aktiviert" einschalten.

Achtung: number.ladestromstarke und switch.aufladung existieren auch als Entities. Die sind zum Anschauen da. Falls du das Laden über EVCC steuerst, darfst du diese Entities nicht in Automationen verwenden, weil sonst EVCC und deine Automation gleichzeitig Lade-Befehle senden.

Schritt 8: Vehicle Status Card installieren

Die Vehicle Status Card ist eine Custom Card für Home Assistant. Sie zeigt Fahrzeugbild, Fortschrittsbalken für den Akku, Mini-Karte für den Standort und Buttons zum Steuern auf einer Karte.

1. HACS öffnen (in der HA-Sidebar)
2. Oben rechts auf die drei Punkte klicken → Benutzerdefinierte Repositories
3. URL eintragen: https://github.com/ngocjohn/vehicle-status-card
4. Kategorie: Dashboard (nicht Integration, nicht Template)
5. Bestätigen, dann die Card herunterladen und installieren
6. Browser Hard-Reload: Strg+Shift+R (Windows/Linux) oder Cmd+Shift+R (Mac). Das ist wichtig. Ohne Hard-Reload findet Home Assistant die neue Card nicht und zeigt beim Hinzufügen einen Fehler.

Schritt 9: Dashboard-Card konfigurieren

1. Öffne dein Dashboard und klicke oben rechts auf Bearbeiten (Stift-Symbol).
2. Karte hinzufügen → nach "Vehicle Status Card" suchen.
3. Die Card hat einen visuellen Editor. Dort weist du die Entities zu:

Hauptanzeige (oben):

• sensor.DEIN_SLUG_ladezustand als Fortschrittsbalken für den Akkustand
• sensor.DEIN_SLUG_geschatzte_verbleibende_reichweite für die Reichweite

Karte:

• device_tracker.standort für die Mini-Map mit dem Standort deines Autos

Buttons (unten):

• climate.klima zum Klima ein-/ausschalten
• switch.wachter_modus für Sentry Mode
• lock.schloss zum Ver-/Entriegeln

Fahrzeugbild: Du kannst ein Bild deines Teslas als Hintergrund hinterlegen. Am besten ein freigestelltes PNG. Die Card unterstützt auch Slideshows mit mehreren Bildern. Lade das Bild über Samba-Share oder SSH in den Ordner /config/www/ hoch (den Ordner www anlegen, falls er nicht existiert). In der Card referenzierst du es dann als /local/dein-bild.png.

Icons und Aktionen der Buttons lassen sich frei konfigurieren. Im Video zeige ich die Konfiguration Schritt für Schritt am Bildschirm.

Tipp: Die Live-Demo gibt dir einen guten Eindruck, was die Card kann, bevor du sie einrichtest.

Tesla API: Was es kostet

Tesla gibt dir 10 USD Monatsguthaben pro Account. Jeder API-Call kostet einen kleinen Betrag gegen dieses Guthaben. Die Integration fragt Daten nur ab, wenn das Auto wach ist, und lässt es danach wieder schlafen. Für die meisten Setups reicht das Budget locker.

Zwei Dinge, die das Budget belasten:

• Climate-Befehle wecken das Auto und erzeugen zusätzliche API-Calls. Eine Automation, die jede Minute den Klima-Status prüft und Befehle sendet, frisst das Guthaben schnell auf.
• Zu häufiges Polling hält das Auto wach. Lass es nachts schlafen und bau keine Automationen, die es ständig aufwecken.

Häufige Probleme