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 that the feature availability depends on the appliance model.
Supported devices
You can find general information about supported devices on the Miele website
The appliance must be connected to the Miele CloudService by using the Miele app.
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:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Miele.
-
Follow the instructions on screen to complete the setup.
The integration configuration may ask for the Client ID and Client Secret created above. See Application Credentials for more details.
Supported functionality
-
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
Unavailable entities for a device
Symptom: “The entities related to an appliance were available but no longer are”
After reloading the Miele integration, the entities related to an appliance that used to be available are no longer available.
Description
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.
Resolution
To try to solve the above issues, follow these steps:
- Turn on the appliance and reload the Miele integration.
- 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.
- If the issue persists, check the connection of the appliance with the Miele API by checking it in the Miele app.
- Open the Miele app.
- Go to the appliance that is experiencing the issue.
- Press the cog-wheel to view more information.
- If everything is correct and the issue persists, contact Miele support.
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
- Go to Settings > Devices & services and select the integration card.
- From the list of devices, select the integration instance you want to remove.
- Next to the entry, select the three-dot
menu. Then, select Delete.