Teslemetry

The Teslemetry integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] exposes various commands and sensors from the Tesla vehicles and energy sites connected to a Teslemetry subscription.

Prerequisites

You must have a Teslemetry account with active subscription.

The virtual key is Teslemetry’s public key, installed in your vehicle through the Tesla app. It is required for fleet telemetry (live streaming) and signed vehicle commands. Since nearly all vehicles support both, nearly all customers need it: if your vehicle supports the virtual key, install it as a standard setup step. Vehicles without virtual-key support are the exception. They still work with Teslemetry at reduced capability—data by polling instead of streaming, and commands unsigned where Tesla permits.

Configuration

To add the Teslemetry hub to your Home Assistant instance, use this My button:

Bluetooth vehicle control

By default, Teslemetry sends every vehicle command through the cloud. If Home Assistant has access to a Bluetooth adapter, you can pair a vehicle over Bluetooth so its commands are sent directly to the car over a local connection, with an automatic fallback to the cloud when the local connection isn’t available.

Requirements

• A Bluetooth adapter available to Home Assistant, such as a built-in adapter or a Bluetooth proxy.
• The vehicle must be within Bluetooth range of that adapter while you set up pairing.
• The vehicle must support Tesla’s vehicle command protocol. Vehicles that don’t, such as certain pre-2021 Model S and Model X vehicles, are not listed when you add a local vehicle.

Setting up Bluetooth control

Bluetooth control is opt-in and set up per vehicle. You add each vehicle you want to control locally from the Teslemetry integration.

1. Go to Settings > Devices & services and select the Teslemetry integration.
2. Select Add local vehicle.
3. Choose the account vehicle you want to control over Bluetooth, then select Submit.
4. Home Assistant looks for the vehicle over Bluetooth. Make sure the vehicle is within range and that fewer than three phone keys are nearby, then continue.
5. If the vehicle doesn’t have Home Assistant’s Bluetooth key on its key list yet, Home Assistant asks you to add it. Select Submit, then tap your key card on the center console card reader within about 30 seconds. The vehicle’s touchscreen shows a prompt while it waits for the card. If the card isn’t tapped in time, select Submit again and tap it sooner.

You only need to do this once per vehicle. If Home Assistant’s key is later removed from the vehicle’s key list, the next time you add the vehicle, Home Assistant asks you to tap a key card again.

When the vehicle is within Bluetooth range, its commands use the local connection first, with an automatic fallback to the cloud when needed. This can make commands like locking, unlocking, or flashing the lights feel noticeably faster. When the vehicle is away, its commands use the cloud, and it switches back to Bluetooth on its own when it returns.

Removing Bluetooth control

Removing the Teslemetry integration, or the pairing for a single vehicle, stops Home Assistant from routing that vehicle’s commands over Bluetooth and forgets the stored Bluetooth address. It does not revoke Home Assistant’s virtual key from the vehicle itself. That key stays authorized on the car until you remove it there.

To fully revoke Home Assistant’s access:

1. Sit in the vehicle, and on the touchscreen, select Controls > Locks.
2. In the list of keys, find the one that was added when you set up Bluetooth control for Home Assistant, and select its trash icon.
3. When prompted, confirm the removal by tapping an authenticated key card or key fob against the center console card reader.

If you use other apps that also connect to the vehicle over a virtual key, they’ll appear in the same list, so make sure you remove the correct one.

Local Powerwall control

By default, Teslemetry sends energy site commands through the cloud. If your energy site includes a Powerwall 2 or Powerwall 3, you can pair Home Assistant with your Powerwall so it can send commands directly over your local network. Local commands are faster. Home Assistant automatically falls back to the cloud whenever the local connection isn’t available, so your existing cloud-based energy entities keep working.

Requirements

• A Powerwall 2 or Powerwall 3 that’s reachable on your local network.

Setting up local control

Local control is optional and you add it per energy site. Only sites with a Powerwall can be added, so sites with only a wall connector or solar panels aren’t offered.

To pair your Powerwall or Backup Gateway:

1. Go to Settings > Devices & services and select the Teslemetry integration.
2. Select Add local energy site.
3. Under Energy site, choose the site whose Powerwall you want to control over your local network, then continue.
4. On the Approve the local access key step, flick the On/Off switch on your primary Powerwall off and back on to approve Home Assistant’s access, then continue. You only need to do this once.
5. On the Connect to your Powerwall system step, confirm the local network address that Home Assistant discovered, or edit it if needed, and enter your Powerwall’s Wi-Fi password in the Password field. Only the last 5 characters are needed - find them on the QR label behind the front cover of your Powerwall 3, or behind the Backup Gateway door on Powerwall 2.

Once paired, Home Assistant stores your Powerwall’s address and password and sends energy commands to it directly, falling back to the cloud automatically whenever your Powerwall can’t be reached.

Entities

These are the entities available in the Teslemetry integration. Not all entities are enabled by default, and not all values are always available. Entities in the device tracker platform specifically require the Vehicle location scope, and will appear unavailable otherwise.

Vehicles

The Bluetooth column marks entities whose commands can control the vehicle over Bluetooth when it’s paired and within range of a Home Assistant Bluetooth adapter. See Bluetooth vehicle control for setup and requirements.

Energy sites

Wall connector

Metadata

List of actions

The Teslemetry integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Add charge schedule (teslemetry.add_charge_schedule) Adds or modifies a charging schedule for the vehicle.

• Add precondition schedule (teslemetry.add_precondition_schedule) Adds or modifies a preconditioning schedule for the vehicle.

• Navigate to coordinates (teslemetry.navigation_gps_request) Sets the vehicle’s navigation to a specific latitude and longitude.

• Remove charge schedule (teslemetry.remove_charge_schedule) Removes a charging schedule from the vehicle.

• Remove precondition schedule (teslemetry.remove_precondition_schedule) Removes a preconditioning schedule from the vehicle.

• Set scheduled charging (teslemetry.set_scheduled_charging) Sets a time at which the vehicle should start charging.

• Set scheduled departure (teslemetry.set_scheduled_departure) Sets a departure time so the vehicle schedules charging and preconditioning.

• Set speed limit (teslemetry.speed_limit) Turns the vehicle’s speed limit on or off.

• Time of use settings (teslemetry.time_of_use) Updates the time of use settings for a Tesla energy site.

• Set valet mode (teslemetry.valet_mode) Turns valet mode on or off for the vehicle.

For an overview of every action across all integrations, see the actions reference.

Energy dashboard

The Tesla Fleet API only provides power data for Powerwall and Solar products. This means they cannot be used on the energy dashboard directly.

Energy flows can be calculated from Battery power and Grid power sensors using a Template Sensor to separate the positive and negative values into positive import and export values. The Load power, Solar power, and the templated sensors can then use a Riemann Sum to convert their instant power (kW) values into cumulative energy values (kWh), which then can be used within the energy dashboard.

Data updates

Teslemetry delivers data by streaming or polling, depending on the product. The Data column in the entity tables above shows how each entity is updated:

• Streaming: the value arrives over the live stream in real time.
• Polling: the value comes from Teslemetry’s cached vehicle data.
• Both: the value can arrive by streaming or polling, depending on the vehicle and its configuration.
• — (em dash): the entity does not report data. Buttons send commands, so they have no data source.

Vehicle data

Most vehicles stream their data to Home Assistant in real time. Streaming has no per-update cost, and the integration sets it up and manages it for you. These vehicles do not get entities parked as Polling in the tables above, as that would incur an ongoing command credit cost.

Legacy vehicles (certain pre-2021 Model S & Model X vehicles) that do not support streaming get all entities except those marked as Streaming in the tables above. Teslemetry handles the polling of this data in the cloud as part of your subscription, roughly every 15 minutes, or roughly every 90 seconds if the vehicle qualifies for a polling discount from Tesla.

The integration does not wake a sleeping vehicle to fetch data. Updates pause until the vehicle wakes up on its own or you interact with it.

Energy site data

Energy sites are cloud-polled: live status and site information every 30 seconds, and energy history every 60 seconds.

Known limitations

• Vehicle Sleep: The integration will not actively wake a vehicle to fetch data. However, sending commands (such as locking, unlocking, or climate control) will wake the vehicle.
• Rate Limits: While Teslemetry handles upstream rate limiting with Tesla, excessive polling or command usage from aggressive automations may encounter temporary API limits.
• Virtual Key: See Prerequisites for when a virtual key is needed. To set one up, follow the instructions on the Teslemetry Console.

Troubleshooting

Invalid tokens

If your Teslemetry authentication token becomes invalid or expires, Home Assistant will prompt you to re-authenticate. This typically involves signing in again via the integration’s configuration flow.

Timeouts

Timeouts can occur due to connection issues between Home Assistant, Teslemetry, Tesla, or the vehicle itself (e.g., the vehicle is in an area with poor cellular reception). These are often temporary. If timeouts persist, please contact [email protected].

Examples

Common use cases

• Solar Charging: Automate your vehicle’s charging current or state based on excess solar production to maximize renewable energy usage.
• Smart Preconditioning: Use calendar events or time-based triggers to precondition your vehicle’s cabin temperature before you depart.
• Automatic Garage Door: Automatically open your garage door when you approach your home while navigating.

Automations

Automate charging based on solar production

automation:
  - alias: "Charge Tesla from Solar"
    trigger:
      - platform: numeric_state
        entity_id: sensor.home_solar_power
        above: 3000
    actions:
      - action: switch.turn_on
        target:
          entity_id: switch.my_tesla_charge
      - action: number.set_value
        target:
          entity_id: number.my_tesla_charge_current
        data:
          value: 16

Precondition vehicle before calendar events

automation:
  - alias: "Precondition for Work"
    trigger:
      - platform: calendar
        event: start
        offset: "-00:15:00"
        entity_id: calendar.work
    actions:
      - action: climate.turn_on
        target:
          entity_id: climate.my_tesla_climate

Blueprints

Open Garage Door based on Navigation

Uses the distance to arrival sensor to accurately know when you’re close to a specific location (such as your home), and open a garage door, or other cover entity. Requires you to be navigating to your intended destination, even if you don’t need the directions.

blueprint:
  name: Teslemetry Garage Door Opener
  author: Brett Adams
  description: Opens a garage door when your Tesla is approaching
  domain: automation
  input:
    distance_to_arrival_entity:
      name: Distance to arrival entity
      selector:
        entity:
          filter:
            - integration: teslemetry
              domain: sensor
              device_class: distance
    distance_to_arrival:
      name: Distance to arrival value to trigger open
      selector:
        number:
          min: 0
          max: 100
          step: any
          mode: box
    route_entity:
      name: Route entity
      selector:
        entity:
          filter:
            - integration: teslemetry
              domain: device_tracker
    route_zone:
      name: Route destination
      selector:
        entity:
          filter:
            - domain: zone
    cover_entity:
      name: Garage door entity
      selector:
        entity:
          filter:
            - domain: cover
trigger:
  - platform: numeric_state
    entity_id:
      - !input distance_to_arrival_entity
    below: !input distance_to_arrival
    above: 0
condition:
  - condition: zone
    entity_id: !input route_entity
    zone: !input route_zone
actions:
  - action: cover.open_cover
    target:
      entity_id: !input cover_entity
mode: restart