tplink-deco-api

Python SDK for controlling TP-Link Deco mesh Wi-Fi routers via the internal HTTP API.

Installation

pip install tplink-deco-api

Usage

from tplink_deco_api import DecoClient

with DecoClient("192.168.68.1", "admin", "your-password") as deco:
    for client in deco.get_client_list():
        print(client.name, client.ip, client.connection_type)

Available methods

Session

Typed queries

Client management — deco.clients

update always sends the name: the firmware ignores an edit that does not carry one, so pass the current name to change only the device type. remove forgets an offline client; the router lists it again if it reconnects.

Fixed IPs — deco.address_reservations

from tplink_deco_api import AddressReservation, DecoClient

with DecoClient("192.168.68.1", "admin", "your-password") as deco:
    deco.address_reservations.add(AddressReservation("AA:BB:CC:DD:EE:FF", "192.168.68.50"))
    deco.clients.update("AA:BB:CC:DD:EE:FF", "Living Room TV")

MAC addresses are accepted with : or - separators. Malformed MAC or IPv4 input raises ValueError before any request is sent.

Raw access

request(path, form, data) and request_list(path, form, data) send an authenticated, encrypted request to any endpoint and return the decrypted result (as an object or a list respectively). Use them for the endpoints that have no typed wrapper yet — the full catalogue is documented in docs/endpoints/.

Models

Every method returns typed dataclasses — no generic dictionaries.

client.mac              # "AA:BB:CC:DD:EE:FF"
client.name             # "MacBook Pro"
client.ip               # "192.168.68.10"
client.connection_type  # "band6"
client.online           # True

device.device_model     # "BE65"
device.software_ver     # "1.2.10 Build 20251229"

wlan.band2_4.host.ssid      # "My Network"
wlan.band2_4.guest.password # "guest-password"

perf.cpu_usage  # 0.03
perf.mem_usage  # 0.42

Requirements

• Python 3.14+
• TP-Link Deco router reachable on the local network

Support

This SDK is built and maintained on personal time, on hardware bought for the purpose. If it is useful to you, consider sponsoring the work — it keeps the devices, the testing and the releases coming.

License

MIT