TP-Link Kasa + Home Assistant

1. Supported Devices

The TP-Link integration in Home Assistant supports a wide range of Kasa devices. Here are the most popular models and what they expose:

Smart Plugs

• KP115: Smart plug with energy monitoring (wattage, voltage, current, daily/monthly kWh). Our top recommendation for tracking individual appliance costs.
• EP25: Compact smart plug with energy monitoring. Same power tracking as KP115 in a smaller form factor that doesn't block adjacent outlets.
• HS103/HS105: Basic on/off smart plugs without energy monitoring. Good for simple on/off control of lamps and small appliances.
• KP125: Slim profile plug with energy monitoring. Similar to KP115 but in a more compact design.
• EP10: Budget smart plug without energy monitoring. Smallest Kasa plug available.

Smart Switches and Dimmers

• HS200: In-wall smart switch. Replaces standard toggle switches. Requires neutral wire.
• HS220: In-wall smart dimmer. Smooth dimming for dimmable bulbs. Requires neutral wire.
• KS230: Three-way smart switch kit. Includes main switch and companion switch for three-way configurations.
• KS200M: Motion-activated smart switch. Built-in motion sensor for automatic light control.

Smart Bulbs

• KL130: Multicolor smart bulb (A19). Full RGB color and tunable white (2500K-9000K).
• KL135: Updated multicolor bulb with brighter output and improved color accuracy.
• KL110: Dimmable white smart bulb. No color changing, just brightness and warm white.
• KL125: Multicolor bulb with a smaller B22 base.

2. Integration Setup

Kasa devices are among the easiest to set up in Home Assistant because they support auto-discovery on your local network.

Step 1: Initial Device Setup

Before Home Assistant can find your device, it needs to be on your WiFi network:

1. Download the Kasa Smart app on your phone
2. Create a TP-Link account (only needed for initial WiFi provisioning)
3. Add your device through the app and connect it to your WiFi
4. Verify the device works through the app

Step 2: Auto-Discovery in Home Assistant

Home Assistant automatically discovers TP-Link devices on your network:

1. Go to Settings → Devices & Services
2. Look for a TP-Link notification in the "Discovered" section
3. Click Configure
4. The device will be added with appropriate entities

Step 3: Manual Addition (if not auto-discovered)

If auto-discovery doesn't find your device:

1. Go to Settings → Devices & Services
2. Click + Add Integration
3. Search for TP-Link
4. Enter the device's IP address (find it in your router's DHCP table or the Kasa app)

Step 4: Verify Entities

After setup, check the device page for created entities:

• Smart plugs: switch.* entity for on/off, plus sensor.*_current_consumption and sensor.*_total_consumption for energy monitoring models
• Smart switches: switch.* or light.* entity depending on the model
• Smart dimmers: light.* entity with brightness control
• Smart bulbs: light.* entity with brightness, color temperature, and RGB (where supported)

3. Energy Monitoring

The KP115, EP25, and KP125 plugs are standout devices for Home Assistant because they report detailed energy data locally. This makes them ideal for tracking household electricity costs without any subscription.

Available Sensors

• Current Consumption (W): Real-time wattage draw. Updates every few seconds.
• Total Consumption (kWh): Cumulative energy used. Resets monthly or when the device is reset.
• Voltage (V): Current line voltage. Useful for detecting power quality issues.
• Current (A): Current amperage draw.

Using Energy Data in the Energy Dashboard

Home Assistant's built-in Energy Dashboard can use Kasa energy sensors:

1. Go to Settings → Dashboards → Energy
2. Under "Individual Devices," click Add Device
3. Select the sensor.*_total_consumption entity
4. The dashboard will show per-device daily, weekly, and monthly energy usage

Energy-Based Automations

Energy monitoring enables powerful automations that basic smart plugs cannot do:

automation:
  - alias: "Alert when dryer finishes"
    trigger:
      - platform: numeric_state
        entity_id: sensor.dryer_plug_current_consumption
        below: 5
        for: "00:03:00"
    condition:
      - condition: numeric_state
        entity_id: sensor.dryer_plug_current_consumption
        above: 0
    action:
      - service: notify.mobile_app
        data:
          title: "Laundry"
          message: "The dryer has finished its cycle"

4. Automation Ideas

Turn Off High-Draw Devices at Budget Threshold

automation:
  - alias: "Turn off space heater when daily budget exceeded"
    trigger:
      - platform: numeric_state
        entity_id: sensor.space_heater_total_consumption
        above: 10  # kWh daily limit
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.space_heater_plug
      - service: notify.mobile_app
        data:
          title: "Energy Budget"
          message: "Space heater turned off. Daily energy limit reached."

Schedule-Based Control

automation:
  - alias: "Turn on porch lights at sunset"
    trigger:
      - platform: sun
        event: sunset
        offset: "-00:15:00"
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.porch_light_plug

  - alias: "Turn off porch lights at midnight"
    trigger:
      - platform: time
        at: "00:00:00"
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.porch_light_plug

Presence-Based Automation

automation:
  - alias: "Turn off all Kasa plugs when house is empty"
    trigger:
      - platform: state
        entity_id: group.family
        to: "not_home"
        for: "00:10:00"
    action:
      - service: switch.turn_off
        target:
          entity_id:
            - switch.living_room_lamp
            - switch.bedroom_fan
            - switch.office_monitor

Monitor Phantom Power Draw

automation:
  - alias: "Alert if TV draws power while off"
    trigger:
      - platform: numeric_state
        entity_id: sensor.tv_plug_current_consumption
        above: 15
    condition:
      - condition: state
        entity_id: media_player.living_room_tv
        state: "off"
    action:
      - service: notify.mobile_app
        data:
          title: "Phantom Power"
          message: "TV plug drawing {{ states('sensor.tv_plug_current_consumption') }} W while TV is off"

5. Firmware Compatibility

What to Know

• Older firmware (pre-2024): Generally works with local API. This is the best scenario for Home Assistant users.
• Newer firmware (2024+): Some devices now require TP-Link cloud authentication even for the HA integration. The TP-Link integration has been updated to support this, but it adds cloud dependency.
• Matter firmware: Some devices have been updated to use Matter protocol instead of the local Kasa API. These can be used via the Matter integration in HA.

How to Protect Your Setup

1. Disable auto-updates in the Kasa app (Settings → Firmware Update)
2. Optionally block devices from internet access at your router
3. Check the Home Assistant community forums before updating firmware
4. If buying new devices, verify current firmware compatibility before purchase

6. Troubleshooting

Device Not Discovered

• Ensure the device is on the same subnet as Home Assistant. Devices on IoT VLANs may not be discoverable unless mDNS/broadcast traffic is allowed between VLANs.
• Try manually adding the device by IP address
• Verify the device is connected to WiFi (solid green LED on most models)
• Restart the device by unplugging for 10 seconds

Device Becomes Unavailable Periodically

• Assign a static IP or DHCP reservation for the device in your router
• Check WiFi signal strength. Kasa devices only support 2.4GHz WiFi.
• If using VLANs, ensure the firewall allows traffic from HA to the device on the required ports

Cloud Login Required After Firmware Update

• Newer firmware versions may require TP-Link cloud credentials in the integration
• Go to Settings → Devices & Services → TP-Link → Reconfigure
• Enter your TP-Link account email and password
• The integration will authenticate and restore local control

Energy Sensors Not Appearing

• Only KP115, EP25, and KP125 models have energy monitoring hardware
• Verify you have the correct model (check the label on the device)
• Try reloading the integration from Settings → Integrations

7. Sources

This guide was compiled from official documentation:

• Home Assistant TP-Link Integration (official docs)
• TP-Link Kasa Product Line

Last verified: 2026-03-20 against Home Assistant 2026.1. If you find outdated information, let us know.