wiz-light-mcp

MCP server for controlling WiZ smart lights from Claude Code and other MCP clients.

"Turn my light blue" / "Set focus mode" / "Discover all my lights" — right from a Claude conversation.

Features

• Discover WiZ bulbs on your local network automatically
• Power control — on, off, toggle
• Color — set any RGB color
• Temperature — warm white (2200K) to cool daylight (6500K)
• Scenes — 32 built-in scenes (Ocean, Focus, Party, Sunset, and more)
• Multi-bulb — control individual bulbs by name or all at once
• Zero config — auto-discovers bulbs, no IP addresses to configure
• Zero dependencies — just the MCP SDK and Node.js built-in UDP

Quick Start

Claude Code

claude mcp add wiz-light -- npx -y wiz-light-mcp

Or add manually to ~/.claude.json:

{
  "mcpServers": {
    "wiz-light": {
      "command": "npx",
      "args": ["-y", "wiz-light-mcp"]
    }
  }
}

Then in any Claude Code conversation:

You: discover my lights
You: turn the bedroom light to sunset mode
You: set all lights to 50% brightness
You: what color is the office light?

Other MCP Clients

Any MCP-compatible client can use this server. Run with stdio transport:

npx wiz-light-mcp

Tools

Tool	Description
discover_lights	Scan the network for WiZ bulbs
list_lights	List previously discovered bulbs
turn_on	Turn on a light (optional brightness)
turn_off	Turn off a light
toggle	Toggle a light's power state
set_color	Set RGB color
set_temperature	Set white color temperature (2200-6500K)
set_scene	Activate a built-in scene by name or ID
get_status	Get current state of a light
list_scenes	List all 32 available scenes

Scenes

Ocean, Romance, Sunset, Party, Fireplace, Cozy, Forest, Pastel Colors, Wake Up, Bedtime, Warm White, Daylight, Cool White, Night Light, Focus, Relax, True Colors, TV Time, Plant Growth, Spring, Summer, Fall, Deep Dive, Jungle, Mojito, Club, Christmas, Halloween, Candlelight, Golden White, Pulse, Steampunk

Requirements

• A WiZ smart bulb on the same WiFi network
• Node.js 18+
• "Allow Local Communication" enabled in the WiZ app

How It Works

WiZ bulbs run a local UDP server on port 38899 that accepts JSON commands — no cloud, no API keys, no authentication. This MCP server sends UDP packets directly to your bulbs on the local network.

Troubleshooting

No bulbs found: Make sure bulbs are powered on, on the same WiFi, and "Allow Local Communication" is enabled in the WiZ app.

Bulb IP changed: Run discover_lights again. Consider setting a static IP in your router's DHCP settings.

Timeout errors: The bulb may be unresponsive. Try power-cycling it.

License

MIT