Divoom LAN Watchface
Wraps Divoom pixel display LAN APIs so Claude can read, patch, and create watchfaces over your local network. Exposes tools for getting current clock info, modifying elements like fonts and colors, swapping backgrounds, adjusting brightness, and creating new faces from images or tar.gz bundles. Ships with read-before-write safety rules and a separate v2 visual editor for previewing ItemList structures before letting the AI apply patches. Useful when you want natural language control over a Divoom device without manually constructing JSON payloads, or when prototyping watchface tweaks in conversation and pushing them straight to hardware. Requires device IP and assumes you understand the multipart dial asset rules for create operations.
- GitHub stars
- 1
- tools
- 42
- auth
- Required
- transport
- STDIO
- env vars
- 3
- last updated
- May 11, 2026
Tools
42 toolsPublic tool metadata for what this MCP can expose to an agent.
watchface_list_devicesreturns selectable TimesFrame/AstroToo/PIXOO64/TimeGate targets with product-specific default ports
returns selectable TimesFrame/AstroToo/PIXOO64/TimeGate targets with product-specific default ports
No parameter schema in public metadata yet.
watchface_get_device_infohardware identification and LAN capability report
hardware identification and LAN capability report
No parameter schema in public metadata yet.
watchface_get_localDevice/GetLocalClockInfo
Device/GetLocalClockInfo
No parameter schema in public metadata yet.
watchface_patch_localmanaged-slot upsert with no caller-supplied ClockId. Existing configurations use Device/PatchLocalClockInfo; a missing configuration is created when a backdrop and complete item tables are supplied.
managed-slot upsert with no caller-supplied ClockId. Existing configurations use Device/PatchLocalClockInfo; a missing configuration is created when a backdrop and complete item tables are supplied.
No parameter schema in public metadata yet.
watchface_get_fonts_localDevice/GetLocalFontList
Device/GetLocalFontList
No parameter schema in public metadata yet.
watchface_get_store_market_listDevice/GetStoreClockMarketList
Device/GetStoreClockMarketList
No parameter schema in public metadata yet.
watchface_set_clock_selectChannel/SetClockSelectId (TimesFrame queues a paired request inside one serialized MCP operation so a manual selection suppresses the active traditional schedule for the current period; AstroToo sends once)
Channel/SetClockSelectId (TimesFrame queues a paired request inside one serialized MCP operation so a manual selection suppresses the active traditional schedule for the current period; AstroToo sends once)
No parameter schema in public metadata yet.
watchface_get_brightnessSys/GetBrightness
Sys/GetBrightness
No parameter schema in public metadata yet.
watchface_set_brightnessChannel/SetBrightness
Channel/SetBrightness
No parameter schema in public metadata yet.
watchface_onoff_screenChannel/OnOffScreen (1=on, 0=off)
Channel/OnOffScreen (1=on, 0=off)
No parameter schema in public metadata yet.
watchface_replace_dial_bg_filePOST /replace_clock_dial_bg
POST /replace_clock_dial_bg
No parameter schema in public metadata yet.
watchface_upload_fileAstroToo-only POST /upload_local_asset; returns a temporary local:// staging reference consumed by a successful create/patch.
AstroToo-only POST /upload_local_asset; returns a temporary local:// staging reference consumed by a successful create/patch.
No parameter schema in public metadata yet.
watchface_create_local_clockmanaged-slot multipart upsert with no caller-supplied ClockId: /create_local_clock when missing and /patch_local_clock when already present.
managed-slot multipart upsert with no caller-supplied ClockId: /create_local_clock when missing and /patch_local_clock when already present.
No parameter schema in public metadata yet.
watchface_reset_local_then_cloudDevice/ResetLocalClockFromServer
Device/ResetLocalClockFromServer
No parameter schema in public metadata yet.
watchface_get_screen_snapshotDevice/GetScreenSnapshot (downloads the returned AstroToo snapshot path; TimesFrame keeps its WebP fallback)
Device/GetScreenSnapshot (downloads the returned AstroToo snapshot path; TimesFrame keeps its WebP fallback)
No parameter schema in public metadata yet.
watchface_raw_commandgeneric POST /divoom_api
generic POST /divoom_api
No parameter schema in public metadata yet.
watchface_protocol_quick_referencekey protocol constraints for the model
key protocol constraints for the model
No parameter schema in public metadata yet.
watchface_clock_catalogproduct-specific ClockId, Chinese/English names, fonts, disp and item-id semantics; optional native configuration
product-specific ClockId, Chinese/English names, fonts, disp and item-id semantics; optional native configuration
No parameter schema in public metadata yet.
watchface_disp_catalogmodel-specific disp catalog and filters
model-specific disp catalog and filters
No parameter schema in public metadata yet.
watchface_font_catalogmodel-specific font catalog; with a live AstroToo target it merges local availability into the AstroToo names
model-specific font catalog; with a live AstroToo target it merges local availability into the AstroToo names
No parameter schema in public metadata yet.
watchface_template_searchcurated TimesFrame or AstroToo watchface templates
curated TimesFrame or AstroToo watchface templates
No parameter schema in public metadata yet.
watchface_layout_suggestmodel-specific layout hints; AstroToo never receives TimesFrame coordinate statistics
model-specific layout hints; AstroToo never receives TimesFrame coordinate statistics
No parameter schema in public metadata yet.
pixoo64_get_device_info
No parameter schema in public metadata yet.
pixoo64_send_animation
No parameter schema in public metadata yet.
pixoo64_send_items
No parameter schema in public metadata yet.
pixoo64_send_text
No parameter schema in public metadata yet.
pixoo64_clear_text
No parameter schema in public metadata yet.
pixoo64_set_brightness
No parameter schema in public metadata yet.
pixoo64_onoff_screen
No parameter schema in public metadata yet.
pixoo64_set_channel
No parameter schema in public metadata yet.
pixoo64_play_gif
No parameter schema in public metadata yet.
pixoo64_command_list
No parameter schema in public metadata yet.
timegate_get_device_info
No parameter schema in public metadata yet.
timegate_send_items
No parameter schema in public metadata yet.
timegate_send_text
No parameter schema in public metadata yet.
timegate_clear_text
No parameter schema in public metadata yet.
timegate_set_brightness
No parameter schema in public metadata yet.
timegate_get_brightness
No parameter schema in public metadata yet.
timegate_onoff_screen
No parameter schema in public metadata yet.
timegate_select_clock
No parameter schema in public metadata yet.
timegate_play_gif
No parameter schema in public metadata yet.
timegate_command_list
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
DIVOOM_DEVICE_HOST*Divoom device LAN IP address
DIVOOM_DEVICE_PORTdefault: 9000Divoom device HTTP port
DIVOOM_TIMEOUT_MSdefault: 45000HTTP request timeout in milliseconds
Readme
mcp-divoom-lan
mcp-divoom-lan is an open-source MCP server for TimesFrame/AstroToo watchfaces and PIXOO64/TimeGate LAN display control. TimesFrame/AstroToo query Device/GetHardwareVersion; PIXOO64/TimeGate use discovery Hardware or explicit hardware profiles. Unknown hardware is rejected. The TimesFrame no-response fallback is retained after checking available discovery data.
PIXOO64 Hardware 90/92 uses 80/post; 96 uses 9000/divoom_api. Its 10 dedicated tools send display elements, text, RGB animations and control commands. Hardware 96 command lists execute sequentially in MCP to match the reference firmware. See the PIXOO64 guide and examples. Device firmware is unchanged.
It works together with the v2 HTML visual editor for modifying watchfaces, switching faces, adjusting brightness, and creating new local watchfaces.
Details
- Repository
- github.com/divoomdevelop/mcp-divoom-lan
- Website
- github.com/DivoomDevelop/mcp-divoom-lan
- Package
mcp-divoom-lan- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active