# Divoom LAN Watchface MCP server

> Lets an AI client control Divoom hardware like PIXOO64, TimeGate, and AstroToo to manage watchfaces, animations, and display settings via LAN.

- Repository: https://github.com/DivoomDevelop/mcp-divoom-lan
- Page: https://hostedmcp.org/servers/divoomdevelop/mcp-divoom-lan
- Transport: stdio
- Stars: 8
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add --env DIVOOM_DEVICE_HOST=<DIVOOM_DEVICE_HOST> mcp-divoom-lan -- npx -y mcp-divoom-lan
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-divoom-lan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-divoom-lan"
      ],
      "env": {
        "DIVOOM_DEVICE_HOST": "<DIVOOM_DEVICE_HOST>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-divoom-lan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-divoom-lan"
      ],
      "env": {
        "DIVOOM_DEVICE_HOST": "<DIVOOM_DEVICE_HOST>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-divoom-lan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-divoom-lan"
      ],
      "env": {
        "DIVOOM_DEVICE_HOST": "<DIVOOM_DEVICE_HOST>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-divoom-lan]
command = "npx"
args = ["-y", "mcp-divoom-lan"]

[mcp_servers.mcp-divoom-lan.env]
DIVOOM_DEVICE_HOST = "<DIVOOM_DEVICE_HOST>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-divoom-lan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-divoom-lan"
      ],
      "env": {
        "DIVOOM_DEVICE_HOST": "<DIVOOM_DEVICE_HOST>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `DIVOOM_DEVICE_HOST` | yes | no | Divoom device LAN IP address |
| `DIVOOM_DEVICE_MODEL` | no | no |  |
| `DIVOOM_DEVICE_PORT` | no | no | Divoom device HTTP port |
| `DIVOOM_TIMEOUT_MS` | no | no | HTTP request timeout in milliseconds |

## FAQ

### What hardware devices does this server support?

It supports TimesFrame, AstroToo, PIXOO64, and TimeGate watchfaces and displays.

### How do I control multiple Divoom devices?

If you leave the DIVOOM_DEVICE_HOST environment variable unset, you can pass a different target host in each tool call to control several devices.

### Does using this server change my device firmware?

No, the device firmware remains unchanged when using these tools.

### What is required to control a TimeGate device?

TimeGate hardware requires a LocalToken obtained from the device settings for authenticated calls.