Render and push styled pixel art, text, dashboards, and animations to Divoom Pixoo LED displays on your local network via MCP. STDIO or Streamable
Pixoo MCP server exists for a simple reason — assistants are far more useful when they can act on Pixoo directly instead of describing what you should do. Render and push styled pixel art, text, dashboards, and animations to Divoom Pixoo LED displays on your local network via MCP. STDIO or Streamable HTTP.
Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.
Once Pixoo is connected, these are the calls the assistant has available:
pixoo_display_text — Render styled text (theme, gradient, shadow, outline, auto-fit) onto the display and push it. Returns the rendered frame as an imagepixoo_compose_scene — Compose a full scene: layered elements (text, icons, widgets, shapes, bitmaps, images, sprites) with per-element effects and keyframes, static orpixoo_push_image — Load an image (absolute local path or https URL), resize it to the LED grid, and push it. Returns the downsampled result as an imagepixoo_overlay_text — Set or clear a device-native scrolling text overlay. Uses device-rendered fonts; overlays persist across channel switches until clearedpixoo_control_device — Read or change device state: brightness, screen on/off, channel, or clock face. Call with no params for a status readpixoo_discover_devices — Find Pixoo devices on the local network via Divoom's cloud discovery endpoint. Run once during setup to find device IPspixoo_design_brief — Return craft guidance and live device context for a design topic. Covers legibility rules, palette discipline, layout zones, animation budget, andPrerequisites — The Prerequisites tool exposed by this serverInstallation — The Installation tool exposed by this serverYou will need 3 environment variables: MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, PIXOO_IP. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
push: false) work without a configured device.This sits in the file and storage access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Pixoo's toolset — pixoo_display_text, pixoo_compose_scene, pixoo_push_image and 6 more — is a fair guide to whether it matches your workflow. It is maintained by cyanheads; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Pixoo's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| pixoo_display_text | Render styled text (theme, gradient, shadow, outline, auto-fit) onto the display and push it. Returns the rendered frame as an image. |
| pixoo_compose_scene | Compose a full scene: layered elements (text, icons, widgets, shapes, bitmaps, images, sprites) with per-element effects and keyframes, static or animated. Returns the rendered scene as an image. |
| pixoo_push_image | Load an image (absolute local path or https URL), resize it to the LED grid, and push it. Returns the downsampled result as an image. |
| pixoo_overlay_text | Set or clear a device-native scrolling text overlay. Uses device-rendered fonts; overlays persist across channel switches until cleared. |
| pixoo_control_device | Read or change device state: brightness, screen on/off, channel, or clock face. Call with no params for a status read. |
| pixoo_discover_devices | Find Pixoo devices on the local network via Divoom's cloud discovery endpoint. Run once during setup to find device IPs. |
| pixoo_design_brief | Return craft guidance and live device context for a design topic. Covers legibility rules, palette discipline, layout zones, animation budget, and pre-filled next-tool suggestions. |
| Prerequisites | The Prerequisites tool exposed by this server. |
| Installation | The Installation tool exposed by this server. |
{
"mcpServers": {
"pixoo-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": ["@cyanheads/pixoo-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"PIXOO_IP": "192.168.1.50"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
push: false) work without a configured device.| Variable | Description | Required |
|---|---|---|
| MCP_TRANSPORT_TYPE | Configuration value read at startup. | Optional |
| MCP_LOG_LEVEL | Configuration value read at startup. | Optional |
| PIXOO_IP | Configuration value read at startup. | Optional |
Scoped local file access — read, write, search and reorganise files in directories you explicitly allow.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Chat with your second brain — search, read and write vault notes through the Local REST API.
Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.