"Mercedes-Benz" custom component

Mercedes-Benz platform as a Custom Component for Home Assistant.

⚠️ SEEKING NEW MAINTAINER ⚠️
After 8+ years of development, I'm selling my last Mercedes and can no longer maintain this integration effectively. Looking for someone to take over →

IMPORTANT:

• Please login once into the Mercedes-Benz IOS or Android app before you install this component. (For North America, the app name is Mercedes Me Connect)

• Tested Countries: AT, AU, BE, CA, CH, CN, DE, DK, ES, FI, FR, IN, IT, IR, NL, NO, NZ, PT, RO, SE, TH, UK, US

• North America: For Cars built 2019 or newer only

• Thailand, India: Please use the region "Europe".

• Mexico, Brazil,...: Please use the region "APAC"

• China: has some limitations. See here for more details.

• Smart cars data are not available after 2025-01-06

• Discussions, Feature Requests via HA-Community Forum

Installation

• First: This is not a Home Assistant Add-On. It's a custom component.
• There are two ways to install. First you can download the folder custom_component and copy it into your Home-Assistant config folder. Second option is to install HACS (Home Assistant Custom Component Store) and select "MercedesME 2020" from the Integrations catalog.
• How to install a custom component?
• How to install HACS?
• Restart HA after the installation
• Make sure that you refresh your browser window too
• Use the "Add Integration" in Home Assistant, Settings, Devices & Services and select "MercedesME 2020".
• Enter your Mercedes-Benz account credentials (username/password) in the integration setup Important Notes:
• consider using a dedicated Mercedes-Benz account for Home Assistant
• if MFA is enabled on your Mercedes-Benz account, authentication will fail. You must disable MFA or use a separate account without MFA.

How to Prevent Account Blocking

To reduce the risk of your account being blocked, please follow these recommendations:

1. Create a separate MB user account for use with this component.
2. Invite the new user to the vehicle:
   The primary user of the vehicle can invite the new HA-MB account to access the vehicle. Up to six additional users can be invited to each vehicle.
3. Use each account in a single environment only:
   Use one account exclusively in HA or in the official MB tools, but never in both simultaneously.

Important Notes

• Certain features, such as geofencing data, are available only to the primary user.
• If geofencing is required in your HA environment, use the primary user account in HA and the secondary accounts in the official MB apps.

---

Optional configuration values

See Options dialog in the Integration under Home-Assistant/Configuration/Integration.

Excluded Cars: comma-separated list of VINs.
PIN: Security PIN to execute special services. Please use your MB mobile app to setup
Disable Capability Check: By default the component checks the capabilities of a car. Active this option to disable the capability check. (For North America)
Debug Save Messages: Enable this option to save all relevant received message into the messages folder of the component

Available components

Depends on your own car or purchased Mercedes-Benz licenses.

Binary Sensors

• warningwashwater

• warningcoolantlevellow

• warningbrakefluid

• warningenginelight

  attributes:
  warningbrakefluid, warningwashwater, warningcoolantlevellow, warninglowbattery
  

• parkbrakestatus

  attributes:
  preWarningBrakeLiningWear
  

• theftsystemarmed

  attributes:
  carAlarmLastTime, carAlarmReason, collisionAlarmTimestamp, interiorSensor, interiorProtectionStatus, interiorMonitoringLastEvent, interiorMonitoringStatus, exteriorMonitoringLastEvent, exteriorMonitoringStatus, lastParkEvent, lastTheftWarning, lastTheftWarningReason, parkEventLevel, parkEventType, theftAlarmActive, towProtectionSensorStatus, towSensor,
  

• tirewarninglamp

  attributes:
  tireMarkerFrontRight, tireMarkerFrontLeft,tireMarkerRearLeft, tireMarkerRearRight, tirewarningsrdk, tirewarningsprw, tireTemperatureRearLeft, tireTemperatureFrontRight,
  tireTemperatureRearRight, tireTemperatureFrontLeft
  

• windowsClosed

  attributes:
  windowstatusrearleft, windowstatusrearright, windowstatusfrontright, windowstatusfrontleft
  

• remoteStartActive

  attributes:
  remoteStartTemperature
  

• engineState

• chargeFlapACStatus

• Preclimate Status (Preconditioning)

  attributes:
  precondState, precondActive, precondError, precondNow, precondNowError, precondDuration, precondatdeparture, precondAtDepartureDisable, precondSeatFrontLeft, precondSeatFrontRight, precondSeatRearLeft, precondSeatRearRight, temperature_points_frontLeft, temperature_points_frontRight, temperature_points_rearLeft, temperature_points_rearRight,
  
  

• wiperHealth

  attributes:
  wiperLifetimeExceeded
  

Buttons

• Flash light
• Preclimate start
• Preclimate stop

Device Tracker

attributes:
positionHeading

Locks

• lock

  PIN setup in MB App is required. If the pin is not set in the integration options then the lock asks for the PIN.

Sensors

• lock

  attributes:
  decklidstatus, doorStatusOverall, doorLockStatusOverall, doorlockstatusgas, doorlockstatusvehicle, doorlockstatusfrontleft,doorlockstatusfrontright, doorlockstatusrearright, doorlockstatusrearleft, doorlockstatusdecklid, doorstatusrearleft, doorstatusfrontright, doorstatusrearright, doorstatusfrontleft, rooftopstatus, sunroofstatus, engineHoodStatus
  

  Internal value: doorlockstatusvehicle

  Values: 0: vehicle unlocked 1: vehicle internal locked 2: vehicle external locked 3: vehicle selective unlocked

• Fuel Level (%)

  attributes:
  tankLevelAdBlue
  

• Geofencing Violation

  attributes:
  Last_event_zone
  

  Values: ENTER LEAVE

• odometer

  attributes:
  distanceReset, distanceStart, averageSpeedReset, averageSpeedStart, distanceZEReset, drivenTimeZEReset, drivenTimeReset, drivenTimeStart, ecoscoretotal, ecoscorefreewhl, ecoscorebonusrange, ecoscoreconst, ecoscoreaccel, gasconsumptionstart, gasconsumptionreset, gasTankRange, gasTankLevel, liquidconsumptionstart, liquidconsumptionreset, liquidRangeSkipIndication, rangeliquid, serviceintervaldays, tanklevelpercent, tankReserveLamp, batteryState, tankLevelAdBlue
  

• Oil Level (%)

• Range Electric

  attributes:
  chargingstatus, distanceElectricalReset, distanceElectricalStart, ecoElectricBatteryTemperature, endofchargetime, maxrange, selectedChargeProgram, precondActive [DEPRECATED], precondNow [DEPRECATED], precondDuration [DEPRECATED]
  
  

• Electric consumption start

• Electric consumption reset

• Charging power

• Charging Power Limit

  attributes:
  chargingPowerRestriction
  

• Starter Battery State

  Internal Name: starterBatteryState
  
  Values     Description_short     Description_long
  "0"        "green"               "Vehicle ok"
  "1"        "yellow"              "Battery partly charged"
  "2"        "red"                 "Vehicle not available"
  "3"        "serviceDisabled"     "Remote service disabled"
  "4"        "vehicleNotAvalable"  "Vehicle no longer available"
  

• tirepressureRearLeft

• tirepressureRearRight

• tirepressureFrontRight

• tirepressureFrontLeft

• State of Charge (soc)

  Internal Name: soc
  
  State of charge (SoC) is the level of charge of an electric battery relative to its capacity. The units of SoC are percentage points (0% = empty; 100% = full).
  
  attributes:
  maxSocLowerLimit, maxSoc
  
  

• Ignition state

  Internal Name: ignitionstate
  
  Values     Description_short     Description_long
  "0"        "lock"                "Ignition lock"
  "1"        "off"                 "Ignition off"
  "2"        "accessory"           "Ignition accessory"
  "4"        "on"                  "Ignition on"
  "5"        "start"               "Ignition start"
  

• Aux Heat Status

  Internal Name: auxheatstatus
  
  Values    Description
  "0"       inactive
  "1"       normal heating
  "2"       normal ventilation
  "3"       manual heating
  "4"       post heating
  "5"       post ventilation
  "6"       auto heating
  
  attributes:
  auxheattime1, auxheattime2, auxheattime3, auxheattimeselection, auxheatActive, auxheatwarnings, auxheattime2, temperature_points_frontLeft, temperature_points_frontRight
  
  

• Departure Time

  Internal Name: departuretime
  
  Planned departure time to initiate preclimate functions
  
  attributes:
  departureTimeWeekday
  
  

Diagnostic Sensors

Diagnostic sensors are hidden by default, check the devices page to see the current values

• Car

  attributes:
  full_update_messages_received, partital_update_messages_received, last_message_received, last_command_type, last_command_state, last_command_error_code, last_command_error_message
  

• RCP_Features

  Sensor shows true if extended configuration like interior lighting is available. This feature requires a reauthentication in case you used a version <0.6 before (We need some more permissions...). Shows False in c