2025.5.3
Home ▸ Integrations ▸

Miele

The Miele integrationsIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows users to integrate their home appliances using the official 3rd party API.

Miele is known as a manufacturer of premium appliances for cooking, laundry care, and floor care.

Use cases

  • Monitor the multiple sensors of the appliance and trigger automations based on these sensors.
  • Monitor the program status of the appliances.
  • Control settings on the appliances.

Note

Note that the feature availability depends on the appliance model.

Supported devices

You can find general information about supported devices on the Miele website. The integration supports any Miele appliance connected to a Miele user account. Miele WiFiConn@ct appliances can be connected directly via a Wi-Fi router. Miele Zigbee appliances must use the Miele@home Gateway XGW3000.

The appliance must be connected to the Miele CloudService by using the Miele app.

Note

New generation washer/dryers and new generation vacuum cleaners: Endpoints for the new generations are not yet available and will be released in the fall of 2025.

Prerequisites

Manual entry of authentication credentials
  • Visit https://www.miele.com/developer and sign up for a developer account.
  • Enter an arbitrary name for your connection and the email of your login for the original Miele app.
  • On success, you will get an email with an activation link. Press the Activate button. Make note of the client ID and secret - you will need them for the next step. You may be prompted to create an [Application - The provided Miele User Account email address must be all lowercase; otherwise, it will result in authentication failures.
  • The password should not contain any special characters. Even though it works in the Miele app, it may not work with the API.
  • Allow a couple of minutes to get the activation email. All changes in the developer portal take a couple of minutes before the change is implemented. Save your credentials as you will need them later.
I have manually disabled My Home Assistant

If you don’t have My Home Assistant on your installation, you can use <HOME_ASSISTANT_URL>/auth/external/callback as the redirect URI instead.

The <HOME_ASSISTANT_URL> must be the same as used during the configuration/ authentication process.

Internal examples: http://192.168.0.2:8123/auth/external/callback, http://homeassistant.local:8123/auth/external/callback.

Configuration

To add the Miele integration to your Home Assistant instance, use this My button:

Miele can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

The integration configuration may ask for the Client ID and Client Secret created above. See Application Credentials for more details.

Supported functionality

Note

  • The entities’ availability depends on the appliance type and the generation of the product, and the appliance might not support all the entities for its type. Please refer to the product manual for details on implementation of specific functions.

  • Products from professional and semi-professional series are generally not supported due to the limitations in the Miele 3rd party API.

  • Some appliances don’t report data while they are turned off, so corresponding entities will not appear in the Miele integration after loading until the appliances are turned on.

Binary sensor

List of binary sensors
  • Operation state:
    • Door: Shows if the door on the appliance is open or closed.
    • Full remote control: Shows the state of Full remote control feature on appliances that supports it.
    • Mobile start: Shows the state of Mobile start feature on appliances that supports it.
    • Notification active: Shows if there is a notification message active on the appliance. The API does not supply any information on the details of the notifications.
    • Problem: Shows if there is an error message active on the appliance. The API does not supply any information on the details of the error.
    • Smart grid: Shows the state of Smart grid feature on appliances that supports it.

Button

List of button entities

Button entities are used to control program progress in washing machines, dryers, dishwashers, robot vacuum cleaners, and others. The exact response to pressing a button can vary slightly between product models, but the result is usually intuitive. The API enables and disables the buttons according to the actual state of the appliance. Most appliances require you to manually activate mobile start or remote control mode.

  • Start: Starts or resumes a program.
  • Pause: Pauses a program.
  • Stop: Stops a program.

Climate

List of climate entities

Climate entities are used to control target temperatures in refrigerators, freezers, and wine cabinets. One, two, or three zones can be controlled depending on the capabilities of the appliance.

Fan

List of fan entities
  • Fan: The speed of extraction fans can be monitored and controlled in many models of cooker hoods and combined induction hobs with integrated extraction fans.

Light

List of light entities
  • Light: The light can be turned on and off in many models of ovens, cooker hoods, and wine cabinets.
  • Ambient light: Some models of cooker hoods have ambient light that can be turned on and off.

Sensor

List of sensors
  • Operation state:
    • Status: Represents the current operation state of the device. The default entity name is just the appliance type. For example, “Dishwasher”.
    • Program: Shows the currently active program.
    • Program phase: Shows the current phase in the running program.
    • Program type: Shows the current program type.
    • Spin speed: Shows the spin speed selected for the current washing machine program.
    • Energy consumption: Shows the energy consumption during the current program cycle. The value will be reset after finishing the program.
    • Water consumption: Shows the water consumption during the current program cycle. The value will be reset after finishing the program.
    • Temperature: Represents the current temperature in refrigerators, freezers, and ovens. Entities are created for up to 3 zones depending on the device capabilities.
    • Elapsed time: Shows the number of minutes that the current program has been running.
    • Remaining time: Shows the estimated number of minutes remaining in the current program cycle. This value can fluctuate during a program cycle based on load dirtiness or water‑heating time.
    • Start in: Shows the number of minutes until a delayed program start, if configured.

Switch

List of switch entities
  • Power: The Power switch has slightly different characteristics depending on the appliance model. For some devices, it works more or less as a traditional power switch, while it behaves like a wake-up/sleep toggle on others. The availability of the switch is controlled by the API, depending on the operational state of the appliance.
  • Supercooling: The switch controls Supercooling mode for refrigerators.
  • Superfreezing: The switch controls Superfreezing mode for freezers.

Automation examples

Get started with these automation examples

Send a notification when the appliance ends the program

Example YAML configuration 
alias: "Notify when program ends"
triggers:
  - trigger: state
    entity_id:
      - sensor.washing_machine
    to: program_ended
actions:
  - service: notify.notify
    data:
      message: "The appliance has finished the program."

Data updates

This integration uses server-sent events from the Miele API to receive live updates from the appliances. When the configuration entry is loaded or after a streaming error (for example after disconnection), the integration will request all data (such as appliance info, available commands, programs, settings, and status) for all appliances.

Known limitations

  • The Miele 3rd party API does not fully match the Miele app. Some programs, options, or settings available in the app may not be accessible or usable via the API.
  • This integration supports only one integration entry, as the Miele 3rd party API does not allow for the unique identification of an account.

Troubleshooting

Problem: Unavailable entities for a device

After reloading the Miele integration, the entities related to an appliance that used to be available are no longer available.

Unavailable entities can have multiple causes:

  • The appliance is turned off. When it is turned off, the appliance is disconnected and the API does not retrieve information about the appliance.
  • The appliance is experiencing a network issue.
  • The Miele API is experiencing issues.

To try to solve the above issues, follow these steps:

  1. Turn on the appliance and reload the Miele integration.
  2. If the appliance is turned on and the issue persists, check the network connection of the appliance and perform a soft reset on the appliance.
  3. If the issue persists, check the connection of the appliance with the Miele API by checking it in the Miele app.
    1. Open the Miele app.
    2. Go to the appliance that is experiencing the issue.
    3. Press the cog-wheel to view more information.
  4. If everything is correct and the issue persists, contact Miele support.
Problem: Program or program phase is unknown

The most common cause is that the code presented by the API is unknown to the integration. Details of the missing code can be found in the Home Assistant log or in the diagnostic file. Please open an issue on GitHub with the details from the logs. Please also include information on the program or program phase that was active when the message occurred.

Unknown can also be displayed if the state is reported as unknown by the API, usually caused by a temporary malfunction in the cloud service.

Removing the integration

This integration follows standard integration removal. If you have entered your own credentials, you will be asked if you want to keep them or delete them. If you want to delete them later you can do that from the tree-dot menu in Settings > Devices & services.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.