Mazda Connected Services


The Mazda Connected Services integration allows you to retrieve data from a Mazda vehicle. In order to use this integration, you must first register your vehicle using the MyMazda app (iOS/Android).

This integration requires an active Mazda Connected Services subscription and a compatible vehicle. The following Mazda vehicles are Mazda Connected Services capable:

  • Mazda3: 2019+
  • CX-30: 2020+
  • CX-9: 2021+
  • CX-5: 2021+

Configuration

Adding Mazda Connected Services to your Home Assistant instance can be done via the user interface, by using this My button:

Manual configuration steps
The MyMazda API only allows one active session at a time. Therefore, if you use the same account with both Home Assistant and the MyMazda mobile app, you may experience issues ("Multiple devices detected" notifications, session expired warnings, etc.) To fix this, you can create a secondary MyMazda account, and share your vehicle with the secondary account. Log in to the mobile app using the primary account and select Menu > MyMazda > My Vehicle > Drivers > Manage Drivers > Invite Driver. When finished, log into the secondary account with Home Assistant.

Platforms

Sensor

The following sensor entities are available:

  • Fuel remaining
  • Fuel distance remaining
  • Odometer
  • Tire pressure (not available for CX-5 and CX-9 models)

Device tracker

Tracks the current location of the vehicle. This will generally update when the vehicle is switched off.

Lock

Displays the current door lock status of the vehicle, and locks/unlocks the doors of the vehicle.

The "Automatic Re-Lock" feature will automatically re-lock the doors if they are not opened shortly after being unlocked. This applies regardless of whether you are using the key, or unlocking the doors remotely using Home Assistant or the MyMazda app.

Services

This integration offers several services for interacting with Mazda vehicles.

Service mazda.start_engine

Starts the vehicle engine. The vehicle engine can only be remotely started 2 consecutive times. To reset this counter, the vehicle must be driven.

Service Data Attribute Required Description
device_id yes The device ID of the vehicle to start

Service mazda.stop_engine

Stops the vehicle engine. This only works if the vehicle was remotely started.

Service Data Attribute Required Description
device_id yes The device ID of the vehicle to stop

Service mazda.start_charging

Starts charging the vehicle battery. This only works with electric vehicles.

Service Data Attribute Required Description
device_id yes The device ID of the vehicle to start charging

Service mazda.stop_charging

Stops charging the vehicle battery. This only works with electric vehicles.

Service Data Attribute Required Description
device_id yes The device ID of the vehicle to stop charging

Service mazda.send_poi

Send a GPS location to the vehicle’s navigation system as a POI (Point of Interest). Requires a navigation SD card installed in the vehicle.

Service Data Attribute Required Description
device_id yes The device ID of the vehicle to send the GPS location to
latitude yes The latitude of the location to send.
longitude yes The longitude of the location to send.
poi_name yes A friendly name for the location.

Service mazda.turn_on_hazard_lights

Turn on the vehicle hazard lights. The lights will flash briefly and then turn off.

Service Data Attribute Required Description
device_id yes The device ID of the vehicle to turn hazard lights on

Service mazda.turn_off_hazard_lights

Temporarily turn off the vehicle hazard lights if they have been manually turned on from inside the vehicle. If a door is opened, the hazard lights will turn back on.

Service Data Attribute Required Description
device_id yes The device ID of the vehicle to turn hazard lights off

Disclaimer

This integration is not affiliated with or endorsed by Mazda.