Divoom LAN Watchface — Claude Code MCP server: setup
This MCP server controls Divoom LAN watchfaces from AI clients. Use it to inspect, edit, switch, and preview local faces with read-before-write checks.
claude mcp add --env DIVOOM_DEVICE_HOST=<DIVOOM_DEVICE_HOST> --env DIVOOM_DEVICE_PORT=<DIVOOM_DEVICE_PORT> --env DIVOOM_TIMEOUT_MS=<DIVOOM_TIMEOUT_MS> --transport stdio divoom-lan-watchface -- npx -y mcp-divoom-lanWhat Divoom LAN Watchface does
Divoom LAN Watchface exposes TimesFrame and AstroToo LAN APIs as MCP tools. It discovers devices, selects a product profile from the returned Hardware value, and checks the managed configuration before changing it. The tool set covers local watchfaces, brightness, screen state, file uploads, device snapshots, and raw API calls.
Edits use a managed slot, so clients do not provide ClockId themselves. watchface_patch_local handles changes, while watchface_create_local_clock is used for a new face or a full replacement. Catalog tools provide model-specific clocks, fonts, disp values, templates, and layout guidance. Claude Code needs the device address in DIVOOM_DEVICE_HOST.
An empty ItemList from GetLocalClockInfo stops writes until an editable watchface is selected. If device detection gets no response, the server falls back to the TimesFrame profile; an explicit unknown Hardware value is rejected.
What it helps with
- discover Divoom devices on the LAN
- inspect the current local watchface
- patch a watchface before writing it
- switch the selected face or screen brightness
- upload an asset for a local watchface
Example prompts for the agent
- Find the Divoom devices on my LAN and show their detected models.
- Read the current local watchface and replace its background with
background.png. - Switch the device to another watchface, then retrieve a screen snapshot.
How to install Divoom LAN Watchface
Platform CLI
claude mcp add --env DIVOOM_DEVICE_HOST=<DIVOOM_DEVICE_HOST> --env DIVOOM_DEVICE_PORT=<DIVOOM_DEVICE_PORT> --env DIVOOM_TIMEOUT_MS=<DIVOOM_TIMEOUT_MS> --transport stdio divoom-lan-watchface -- npx -y mcp-divoom-lanReplace <…> with your own values
Platform CLI
codex mcp add divoom-lan-watchface --env DIVOOM_DEVICE_HOST=<DIVOOM_DEVICE_HOST> --env DIVOOM_DEVICE_PORT=<DIVOOM_DEVICE_PORT> --env DIVOOM_TIMEOUT_MS=<DIVOOM_TIMEOUT_MS> -- npx -y mcp-divoom-lanReplace <…> with your own values
Config file
{
"mcpServers": {
"divoom-lan-watchface": {
"command": "npx",
"args": [
"-y",
"mcp-divoom-lan"
],
"env": {
"DIVOOM_DEVICE_HOST": "<DIVOOM_DEVICE_HOST>",
"DIVOOM_DEVICE_PORT": "<DIVOOM_DEVICE_PORT>",
"DIVOOM_TIMEOUT_MS": "<DIVOOM_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"divoom-lan-watchface": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-divoom-lan"
],
"env": {
"DIVOOM_DEVICE_HOST": "<DIVOOM_DEVICE_HOST>",
"DIVOOM_DEVICE_PORT": "<DIVOOM_DEVICE_PORT>",
"DIVOOM_TIMEOUT_MS": "<DIVOOM_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DIVOOM_DEVICE_HOST=<DIVOOM_DEVICE_HOST> -e DIVOOM_DEVICE_PORT=<DIVOOM_DEVICE_PORT> -e DIVOOM_TIMEOUT_MS=<DIVOOM_TIMEOUT_MS> divoom-lan-watchface npx -y mcp-divoom-lanReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Divoom LAN Watchface
How do I install Divoom LAN Watchface in Claude Code?
Run claude mcp add mcp-divoom-lan -e DIVOOM_DEVICE_HOST=<DIVOOM_DEVICE_HOST> -- npx -y mcp-divoom-lan.
What does Divoom LAN Watchface do?
It gives an MCP client tools for finding Divoom devices, reading and editing local watchfaces, switching faces, and controlling screen settings. Writes are checked against the managed slot first.
What happens when device detection gets no response?
The server uses the TimesFrame profile for compatibility with older devices. An explicit unknown Hardware value is rejected.
