2026.6.4
Home ▸ Integrations

Neato Botvac

There is an active alert for this integration!
LEARN MORE

The Neato integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control your Neato Botvac Connected Robots.

Important

Vorwerk is phasing out Neato cloud services. On 6 October 2025, they announced that the cloud platform can no longer be maintained in a reliable and future-proof way.

Because the Neato Developer Network is no longer available, you can no longer set up this integration as a new installation. Existing setups may continue to work until the cloud is fully shut down.

There is support for the following platform types within Home Assistant:

  • Camera - allows you to view the latest cleaning map.
  • Sensor - allows you to view the battery level.
  • Switch - allows you to enable or disable the schedule.
  • Button - allows you to dismiss an alert visible in the app.
  • Vacuum

Prerequisites

Previously, you would visit the Neato Developer Network to create a new app and obtain credentials. The Neato Developer Network is no longer available, so new credentials can no longer be created. The steps below are kept for reference for users who already have existing credentials.

Important

You will have to enter a name, a description, and the redirect URI:

  • Name: can be anything you like, for example, “Home Assistant”.
  • Description: can be anything you like, for example, “Home Assistant integration for Neato”
  • Redirect URI: https://my.home-assistant.io/redirect/oauth
  • Terms Of Service URL: leave blank
  • Privacy Policy URL: leave blank

You have to select all three scopes (public_profile, control_robots and maps).

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: https://192.168.0.2:8123/auth/external/callback, https://homeassistant.local:8123/auth/external/callback.”

Your instance must be accessible via HTTPS. However, your instance does not need to be exposed to the Internet.

Configuration

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

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Neato Botvac.

  • Follow the instructions on screen to complete the setup.

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

Note

After the update to firmware 4.0 (which adds cleaning maps) there is also support for displaying the maps of the Botvac D3 Connected and Botvac D5 Connected robots. More information on how to update can be found here.

Button

Each neato vacuum has a Dismiss alert button. This allows you to dismiss an alert visible in the app (e.g. dust bin full) and preventing the vacuum to start cleaning.

Vacuum

The neato vacuum platform allows you to control your Neato Botvac Connected. The status includes attributes about the robot’s last cleaning session.

List of actions

The Neato Botvac 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.

  • Custom cleaning (neato.custom_cleaning) Starts a custom cleaning run on a Neato Botvac.

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

Troubleshooting

My robot is unavailable

Try to restart the vacuum and wait about 5 minutes to see if it is no longer unavailable. If you are still having issues check the Neato app and make sure your robot is connected and working. If it is not then follow the steps in the app to reset your robot and give it the same name as before then restart Home Assistant.

My robot is not detected by Home Assistant

Please check your logs if there are any warnings. When there is a message about your robot being offline, check if it is connected to the internet and available though the app. If there is a message about a bad response, try to reset this robot via your app.

There is a warning about a bad response but everything works as expected

Do you have a stale robot in your configuration? Try to look into your account and delete any stale robots. If these warnings are about actively used robots, please report an issue to help us solving this problem.

Server got itself in trouble

If you see this message after trying to set up Neato, please check if the setup still worked or not. If not, try again and make sure you start the process only once. Do not click the “Open External Page” button if a page has already opened by itself. Be patient and wait for the setup to complete.