tapo
๐ฆ Rust API, ๐ Python API, and ๐ค MCP Server for TP-Link Tapo smart devices
Install
docker run -i --rm ghcr.io/mihai-dinculescu/tapo-mcp:0.5.1TAPO_MCP_USERNAMErequired ยท secret โ TP-Link Tapo account emailTAPO_MCP_PASSWORDrequired ยท secret โ TP-Link Tapo account passwordTAPO_MCP_DISCOVERY_TARGETrequired โ Network target for device discovery (e.g. 192.168.1.255)TAPO_MCP_API_KEYoptional ยท secret โ Optional Bearer token for API authenticationTAPO_MCP_DISCOVERY_TIMEOUToptional โ Device discovery timeout in secondsOTEL_EXPORTER_OTLP_ENDPOINToptional โ Optional OpenTelemetry collector endpoint for tracing
Tapo
Unofficial Tapo API Client. Works with TP-Link Tapo smart devices. Tested with light bulbs (L510, L520, L530, L535, L610, L630), light strips (L900, L920, L930), plugs (P100, P105, P110, P110M, P115), power strips (P300, P304M, P306, P316M), hubs (H100, H200, H500), switches (S200B, S200D, S210), sensors (KE100, T100, T110, T300, T310, T315) and cameras (C210, C220, C225, C325WB, C520WS, TC40, TC70).
Supported Devices
See /SUPPORTED_DEVICES.md for the supported devices and feature matrix.
Rust Library
Usage
Cargo.toml
[dependencies]
tapo = "0.10"
main.rs
let device = ApiClient::new("<tapo-username>", "tapo-password")
.p110("<device ip address>")
.await?;
device.on().await?;
Examples
export TAPO_USERNAME=
export TAPO_PASSWORD=
export IP_ADDRESS=
cargo run --example tapo_l530
See all examples in /tapo/examples.
Python Library
Usage
pip install tapo
client = ApiClient("<tapo-username>", "tapo-password")
device = await client.p110("<device ip address>")
await device.on()
Examples
cd tapo-py
uv venv # On the initial run only
uv sync --group dev --locked
uv run maturin develop # On the initial run and whenever the Rust code is modified
export TAPO_USERNAME=
export TAPO_PASSWORD=
export IP_ADDRESS=
uv run python examples/tapo_p110.py
See all examples in /tapo-py/examples.
MCP Server
An MCP server that exposes Tapo devices as AI-callable tools and resources via the Model Context Protocol. See /tapo-mcp/README.md for setup and usage.
Community Projects
- tapo-rest โ a REST wrapper of this library that can be deployed as a service or serve as an advanced example.
- tapoviz โ audio-reactive and screen-reactive lighting for L920/L930 LED strips, with a local web UI.
Troubleshooting
See /TROUBLESHOOTING.md for solutions to common issues.
Contributing
Contributions are welcome and encouraged! See /CONTRIBUTING.md.
Sponsors
A big thank you to the sponsors of this project!
Credits
Inspired by petretiandrea/plugp100.