# Yeelight IoT MCP Server

Wires an AI client into the Yeelight Pro cloud: browse homes, rooms and devices, read live state, run scenes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: Yeelight
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Yeelight/yeelight-iot-mcp
- Updated: 2026-07-23
- HTML: https://affpapa.org/en/nevibecode/mcp/yeelight-iot-mcp-server

## What it does

Eight tools cover topology discovery (homes, areas, rooms, devices, groups, scenes), capability reads, safe control preparation and confirmed execution. Lists come back with cursor pagination. Device control and scene runs start as dry-runs, so the agent lays out a plan and waits for your explicit go-ahead before anything changes.

Transport is Streamable HTTP. You can point a client at the hosted endpoint `https://api.yeelight.com/apis/mcp_server/v1/mcp` or run the source deployment yourself. Local runs need Python 3.10 or later and `uv`, and they still call Yeelight cloud APIs — this is not an offline gateway. Every request has to carry an `Authorization` header with a Yeelight token; without it the server answers nothing, whatever address it is bound to. Region and House ID are optional: the region falls back to a JWT claim, and the first Pro home in that region is picked when House ID is absent.

The `yeelight-home setup` flow prints a QR code you scan in the Yeelight Pro app to get a token. The same setup brings in Metadata MCP alongside this server. If an existing integration already calls `control_node` or `execute_scene`, leave it as is.

## Requirements
- Remote server: `https://api.yeelight.com/apis/mcp_server/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add yeelight-iot-mcp-server --url https://api.yeelight.com/apis/mcp_server/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yeelight-iot-mcp-server": {
            "url": "https://api.yeelight.com/apis/mcp_server/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yeelight-iot-mcp-server": {
            "type": "http",
            "url": "https://api.yeelight.com/apis/mcp_server/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcp
```

## When to use it
- list every room and device in a Yeelight Pro home
- check a lamp's current state before sending a command
- turn lights on through the agent instead of the phone app
- run a scene after reviewing the proposed plan
- page through groups and scenes in a large home

## Example prompts
- Show me all rooms and devices in my Yeelight home
- Draft a plan to switch off the bedroom lights, don't execute yet
- Run the Evening scene in the living room

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md