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

Related MCP server: Nanoleaf MCP Server

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

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