wyzectl

Control Wyze lights and plugs from the command line, or from an AI agent over MCP.

wyzectl covers lights and plugs: Wyze bulbs (white and color) and light strips, the rooms and groups you set up in the Wyze app, and plug on/off (indoor plugs and the outdoor plug's sockets). It can also list every device on the account, read-only. There are no camera, lock or other device controls, on purpose.

It is a thin layer over wyze-sdk, which talks to the same cloud API the Wyze app uses. That API is not publicly documented, so Wyze can change it at any time; when it does, this tool breaks until wyze-sdk catches up.

Install

uv tool install git+https://github.com/detroitpro/wyze@v0.2.0

Python 3.12-3.14.

Related MCP server: mcp-server-tuya

Credentials

Create an API key at the Wyze Developer API Console (Wyze's instructions), then set:

Wyze rate-limits logins, so wyzectl caches the session (access and refresh tokens) in $XDG_CACHE_HOME/wyzectl/session.json (mode 600; override with WYZECTL_CACHE). It refreshes an expired token and logs in again only when the refresh token has expired too. Treat that file like a password: it controls your Wyze account.

Use

wyzectl devices                                   # everything on the account (read-only)
wyzectl lights                                    # every light with on/off, brightness, color
wyzectl groups                                    # rooms/groups from the Wyze app
wyzectl light on "Desk Lamp"
wyzectl light set desk --brightness 40 --temp 2700
wyzectl light set "Office Strip" --color ff8800
wyzectl group off "Living Room"
wyzectl plugs                                     # plugs with on/off state
wyzectl plug on "Chair Light"
wyzectl --json lights
wyzectl session check                             # is the login working?

Names match exactly (case-insensitive) first, then by a unique part of the name. Setting brightness, temperature or color also turns the light on. Ranges: brightness 1-100; white bulbs 2700-6500 K; color bulbs and strips 1800-6500 K or a hex color.

MCP

wyzectl mcp runs an MCP server on stdio with tools list_devices, list_lights, list_groups, get_light, set_light, set_group, list_plugs, get_plug and set_plug. Example client config:

{
  "mcpServers": {
    "wyze": { "command": "wyzectl", "args": ["mcp"] }
  }
}

The server needs the same environment variables. Agents can change your lights with it; that's the point, and it's also why nothing else is exposed.

Develop

uv sync
uv run pytest
uv run ruff check . && uv run ruff format --check .

Tests run against a fake client; they never touch a real account.

License

MIT