How to Set up Tapo on Home Assistant

In this tutorial, we will go through the different methods of setting up Tapo on your Home Assistant Installation.

Home Assistant and Tapo

Tapo is an offshoot of TP-Link that offers a range of smart home devices, including smart plugs, smart cameras, smart bulbs, and more. Most of their products are easy to use, affordable, and are relatively popular. Unfortunately, Tapo devices require an internet connection to work.

Integrating Tapo devices into Home Assistant allows you to monitor and control them without needing to use the Tapo app. It also allows you to create automations within Home Assistant to control these devices. For example, you can use automations or node-red to turn a switch on at a specific time or after a certain event has occurred.

This tutorial will cover two different methods of integrating your Tapo devices into Home Assistant. The first method uses the built-in TP-Link integration. The second method uses a custom integration that we install using HACs.

Using the Home Assistant Tapo Integration

This section will go through the steps of setting up the TP-Link Tapo integration. This method is the easiest, but you may find your device isn’t supported. If it isn’t supported, I recommend checking out the HACs integration instead.

1. First, go to the Settings (1) page and click on Devices & Services (2).

Home Assistant Settings - Go to Devices and Services

2. Now, click the Add Integration button in the bottom right corner.

Click on Add Integration

3. Search for TP-Link or Tapo in the search box (1) at the top of the pop-up. Alternatively, scroll through the different brands until you find TP-Link. Once you find TP-Link (2), click on it.

Search for TP-Link

4. On the next screen, click on Tapo.

Click on Tapo

A prompt reminding you that TP-Link Smart Home provides Tapo devices will appear. Click OK.

Tapo Devices Warning Pop Up

5. If you know your device’s IP address, you can input it into the host field. Alternatively, you can click SUBMIT, and the integration will search for your Tapo devices.

TP-Link Enter IP Address

6. If you did not enter an IP address, a list of devices will appear. Click on the one you wish to add to Home Assistant and then click on SUBMIT.

List of Tapo Devices Found

7. The following pop-up will ask you to enter your TP-Link credentials. You must be the main user for the devices you are adding to Home Assistant. If you are a sub-user, you will likely receive an authentication error.

To proceed, enter the username (1) and password (2) before pressing the SUBMIT (3) button.

Enter TP-Link Details

8. You should see a success message. You can add the new device to an area or click FINISH.

Tapo Device Successfully Added

9. To find the device you added, go to the integrations page and click the TP-Link Smart Home integration.

Tp-Link Smart Home Integration

10. Here, you can see all the devices that you have added using the integration. You can also see devices that the integration has discovered on your network. You can configure them by clicking the CONFIGURE button.

To view more information on a specific device, click on the device link.

Tp-Link Smart Home Integration Details

11. Inside the device page, you can see all the details the integration collects from the device. Our example below is a Tapo P100 smart switch. You can turn it on or off using the controls.

Tapo Device Controls and Info

Using the Tapo HACS Custom Integration

The custom integration we will install is available on GitHub and has a list of all the Tapo devices it supports. This integration is an excellent alternative to the built-in version, especially if you are having difficulty adding your Tapo device. However, check that your device is supported before proceeding.

Before you start this section, you must ensure that the HACs add-on is installed on your Home Assistant installation.

Installing the Tapo HACS Integration

1. Go to the HACS (1) page in your Home Assistant web interface and click on Integrations (2).

HACS Community Store Menu Page

2. Click the Explore & Download Repositories button in the bottom right corner of the screen.

HACS Integrations

3. Now search for Tapo in the search box. You should see two repositories; we will install the second one (Tapo Controller).

HACS Tapo Controller

4. You should now see a screen explaining the integration and its capabilities in Home Assistant. Further down the page, you can also view the Tapo devices the integration will support.

Once you are ready, click on the Download button.

HACS Download Tapo Integration GitHub Information

5. A pop-up will appear. Change these values if you need a different version installed. Otherwise, click on Download.

HACS Download Tapo Pop-up

6. A restart is typically required to activate a HACS integration. To do this, go to the Developer Tools (1) screen and click Restart (2) on this page.

Restart Home Assistant

7. In the pop-up, click on Restart Home Assistant (1) and Restart (2) in the following pop-up. It may take a few minutes to restart the software, depending on your setup and hardware.

Restart Home Assistant pop-up
Restart Home Assistant pop-up confirm

Adding your Devices

9. Now the integration is installed, go to the Settings (1) page and click on Devices & Services (2).

Home Assistant Settings Page - Go to Devices and Services

10. On the integrations page, click on the Add Integration button in the bottom right corner.

Integrations Page - Add Integration

11. In the pop-up search for Tapo (1). Click on the TP-Link Tapo (2) option. The package icon (3) means that it is a custom integration.

TP-Link Tapo HACS Custom Integration

12. Now, you will need to enter the IP address (1) for your Tapo device and the username (2) and password (3) of your TP-Link Smart Home account. Ensure you are the primary user and not a sub-user for your devices; otherwise, you may receive an authentication error.

Once you are ready, click on Submit (4).

Add Details for the Tapo Device

13. If everything is correct, you should see a success pop-up box. You can assign the device to an area (1) or click FINISH (2).

Success Message

14. To view the device we just added to Home Assistant, go to the Settings page and click on Devices & Services.

On this page, scroll to the bottom, and you should see TP-Link Tapo, click on it.

Click on the TP-Link Tapo Integration on the Integrations page

15. The next page should show all the discovered devices you can add to the integration. You can also see your devices that are already set up with Home Assistant.

To view more details on the device we just added, click the 1 device link underneath the device name.

HACS Tapo Integration Devices List

16. You should now see a page that contains all the details of the Tapo device. As you can see in the screenshot below, the device provides us with a switch that we can turn on or off. It also shows the Wi-Fi signal level and whether the device is overheating.

HACS Tapo Device Details

17. You can now add the rest of your Tapo devices. Depending on how many you have to set up, it may take a while, but it is worth it.

Conclusion

I hope you now have your Tapo devices integrated into Home Assistant. If you still have problems, consider alternatives or try another custom integration via HACs. For example, using the Frigate software is a great way to integrate your camera feeds into Home Assistant.

We have many Home Assistant tutorials that I recommend checking out if you want to expand your smart home functionality.

Please let us know if you have any feedback, questions, or anything else.

Leave a Reply

Your email address will not be published. Required fields are marked *

2 Comments

  1. Avatar for Matt
    Matt on

    Any idea how to get the Tapo P400M dual outdoor smart plug to add to HA?

  2. Avatar for Paige
    Paige on

    Many thanks!