Table of Contents

  1. Tapo Device Overview
  2. Official TP-Link Tapo Integration
  3. Step-by-Step Setup
  4. What Gets Created
  5. Local vs Cloud Mode
  6. Automation Examples
  7. Known Issues

TP-Link's Tapo lineup is one of the most popular budget smart home ranges on the market. Tapo plugs, bulbs, light strips, and cameras are affordable, widely available, and genuinely reliable. And since TP-Link added official Home Assistant integration support, getting these devices into HA has become much easier.

This guide covers the official Tapo integration, how to set it up, what entities it creates, and tips for getting the best performance.

Tapo Device Overview

The Tapo range includes:

All WiFi-based Tapo devices can be integrated with Home Assistant. The H100 hub and its accessories (sensors, buttons) are also supported.

Official TP-Link Tapo Integration

Home Assistant includes a built-in TP-Link integration that supports Tapo devices. As of HA 2023.x and later, it offers local API access — meaning it communicates directly with your devices over your local network rather than through TP-Link's cloud.

Note: Older versions of the integration were cloud-based and required your TP-Link account credentials. The newer local API version is significantly faster and more reliable. Make sure you're running HA 2024.1 or later for the best experience.

Step-by-Step Setup

Step 1: Set Up Tapo Devices First

Before adding to HA, set up your Tapo devices using the Tapo app. Connect them to your WiFi network and make sure they're working in the Tapo app.

Step 2: Add the Integration

In Home Assistant, go to Settings → Devices & Services → Add Integration. Search for "TP-Link" and select it.

Step 3: Auto-Discovery

Home Assistant will scan your network for Tapo devices. If found, they'll be listed for you to confirm. Click on a device to add it.

Step 4: Enter Credentials (If Required)

Some Tapo devices require your TP-Link account email and password to authenticate the local API. Enter these when prompted. This is a one-time setup; after pairing, communication is local.

Step 5: Manual Addition

If auto-discovery misses a device, select "Add device manually" and enter the device's IP address. Assign a static IP or DHCP reservation to prevent future issues.

What Gets Created

Depending on your device type, HA creates different entities:

Local vs Cloud Mode

The newer TP-Link integration uses local API communication. Here's what that means in practice:

You can optionally disable cloud access in the Tapo app entirely, though this will prevent you from controlling devices when away from home unless you've set up HA remote access.

Automation Examples

Energy Monitoring with P110

Use the P110's power sensor to track which appliances are running. Create a notification automation: if the washing machine draws 0 watts after drawing more than 10 watts for 30 minutes, it's finished — send a push notification.

Presence-Based Lighting

Use Tapo bulbs with HA's device tracker. When you arrive home (phone connects to WiFi), automatically turn on the entryway lights at 70% brightness. Turn off when you leave.

Colour-Coded Alerts

Use L530E bulbs to signal alerts. Red flash when a door opens at night. Green when the dishwasher finishes. Blue when it's raining. Much more intuitive than push notifications for quick status checks.

Known Issues

Bottom Line

TP-Link Tapo devices offer excellent value for Home Assistant users. The local API integration is fast and reliable for plugs and bulbs. Energy monitoring on the P110 is particularly useful for automations. The main caveat is TP-Link's history of changing their API, which occasionally requires integration updates — but the HA community responds quickly when this happens.

SmartWired participates in the Amazon Associates Programme. We may earn a commission from qualifying purchases at no extra cost to you.