tapo

by mihai-dinculescu

Install this Skill

curl -fsSL -o tapo.zip https://skill.seembox.com/api/v1/skills/tapo/download && unzip tapo.zip

SKILL.md About

---
name: tapo
description: Control TP-Link Tapo smart home devices (lights, plugs, strips, cameras) via [Tapo MCP](https://github.com/mihai-dinculescu/tapo/tree/main/tapo-mcp).
version: 0.3.0
metadata:
  {
    "openclaw":
      {
        "emoji": "📦",
        "requires": { "bins": ["npx"] },
      },
  }
---

# Tapo

Control Tapo devices using `npx mcporter call tapo.<tool>`.

## Setup

You need a [Tapo MCP](https://github.com/mihai-dinculescu/tapo/tree/main/tapo-mcp) server (v0.3.0 or later) running on your network (HTTP transport). Bearer token auth is recommended.

1. **Add the Tapo server**:

```bash
   npx mcporter config add tapo http://<TAPO_MCP_IP> \
     --transport http \
     --header "Authorization=Bearer <YOUR_TOKEN>" \
     --scope home
   ```

2. **Verify**:
   ```bash
   npx mcporter list tapo --schema
   ```
   You should see `list_devices`, `check_device`, `get_device_state`, `control_device`, and `take_snapshot`.

See [references/setup.md](references/setup.md) for the full walkthrough, config management, and troubleshooting.

## Tools

### list_devices

List all Tapo devices on the network.

```bash
npx mcporter call tapo.list_devices
```

Returns each device's `id`, `name`, `model`, `ip`, `set_capabilities`, `get_capabilities`, and `children` (for power strips).

### check_device

Verify a device ID matches at a given IP.

```bash
npx mcporter call tapo.check_device id="<DEVICE_ID>" ip="<IP>"
```

### get_device_state

Get a device's current state. Automatically runs `check_device` first.

```bash
npx mcporter call tapo.get_device_state id="<DEVICE_ID>" ip="<IP>" capability='{"type": "DeviceInfo"}'
```

### control_device

Control a device. Automatically runs `check_device` first.

```bash
# Turn on
npx mcporter call tapo.control_device id="<DEVICE_ID>" ip="<IP>" capabilities='[{"type": "OnOff", "value": true}]'

# Turn off
npx mcporter call tapo.control_device id="<DEVICE_ID>" ip="<IP>" capabilities='[{"type": "OnOff", "value": false}]'

# Set brightness (1-100, lights only)
npx mcporter call tapo.control_device id="<DEVICE_ID>" ip="<IP>" capabilities='[{"type": "Brightness", "value": 50}]'

# Set color (color lights only)
npx mcporter call tapo.control_device id="<DEVICE_ID>" ip="<IP>" capabilities='[{"type": "Color", "value": "Coral"}]'

# Set multiple capabilities at once
npx mcporter call tapo.control_device id="<DEVICE_ID>" ip="<IP>" capabilities='[{"type": "Color", "value": "Coral"}, {"type": "Brightness", "value": 50}]'
```

### take_snapshot

Capture a still JPEG snapshot from a Tapo camera (~640x360). Automatically runs `check_device` first. Requires `TAPO_MCP_CAMERA_USERNAME` and `TAPO_MCP_CAMERA_PASSWORD` configured on the server (Camera Settings > Advanced Settings > Camera Account in the Tapo app).

```bash
npx mcporter call tapo.take_snapshot id="<DEVICE_ID>" ip="<IP>"
```

## Usage rules

1. Always run `list_devices` first if you don't have a recent device list. Cache results for up to 30 minutes.
2. Use the device `id` and `ip` from the list — never guess or hardcopy these values.
3. For power strips (e.g. P304M), children have their own `id`. Use the child `id` with the parent's `ip`.

_meta.json Metadata

{
  "ownerId": "kn7emrrhvxz37g80z9rqyme9j582qan1",
  "publishedAt": 1777151241488,
  "slug": "tapo",
  "version": "0.3.0"
}