Render and push styled pixel art, text, dashboards, and animations to Divoom Pixoo LED displays.
Connect Runs on your machine
claude mcp add pixoo-mcp-server -e PIXOO_IP=<PIXOO_IP> -e PIXOO_SIZE=<PIXOO_SIZE> -e PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> -e PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> -e PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> -e PIXOO_SERVE_PORT=<PIXOO_SERVE_PORT> -e PIXOO_BROWSER_PATH=<PIXOO_BROWSER_PATH> -e PIXOO_HTML_ENABLED=<PIXOO_HTML_ENABLED> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -- npx -y @cyanheads/[email protected]{
"mcpServers": {
"pixoo-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/[email protected]"
],
"env": {
"PIXOO_IP": "<PIXOO_IP>",
"PIXOO_SIZE": "<PIXOO_SIZE>",
"PIXOO_OUTPUT_DIR": "<PIXOO_OUTPUT_DIR>",
"PIXOO_PUSH_MIN_INTERVAL_MS": "<PIXOO_PUSH_MIN_INTERVAL_MS>",
"PIXOO_SERVE_HOST": "<PIXOO_SERVE_HOST>",
"PIXOO_SERVE_PORT": "<PIXOO_SERVE_PORT>",
"PIXOO_BROWSER_PATH": "<PIXOO_BROWSER_PATH>",
"PIXOO_HTML_ENABLED": "<PIXOO_HTML_ENABLED>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}{
"mcpServers": {
"pixoo-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/[email protected]"
],
"env": {
"PIXOO_IP": "<PIXOO_IP>",
"PIXOO_SIZE": "<PIXOO_SIZE>",
"PIXOO_OUTPUT_DIR": "<PIXOO_OUTPUT_DIR>",
"PIXOO_PUSH_MIN_INTERVAL_MS": "<PIXOO_PUSH_MIN_INTERVAL_MS>",
"PIXOO_SERVE_HOST": "<PIXOO_SERVE_HOST>",
"PIXOO_SERVE_PORT": "<PIXOO_SERVE_PORT>",
"PIXOO_BROWSER_PATH": "<PIXOO_BROWSER_PATH>",
"PIXOO_HTML_ENABLED": "<PIXOO_HTML_ENABLED>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}{
"servers": {
"pixoo-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/[email protected]"
],
"env": {
"PIXOO_IP": "<PIXOO_IP>",
"PIXOO_SIZE": "<PIXOO_SIZE>",
"PIXOO_OUTPUT_DIR": "<PIXOO_OUTPUT_DIR>",
"PIXOO_PUSH_MIN_INTERVAL_MS": "<PIXOO_PUSH_MIN_INTERVAL_MS>",
"PIXOO_SERVE_HOST": "<PIXOO_SERVE_HOST>",
"PIXOO_SERVE_PORT": "<PIXOO_SERVE_PORT>",
"PIXOO_BROWSER_PATH": "<PIXOO_BROWSER_PATH>",
"PIXOO_HTML_ENABLED": "<PIXOO_HTML_ENABLED>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
PIXOO_IPOptional | Device IP address on the local network (e.g. 192.168.1.50). Required for device tools; discovery and pure-render (push: false) work without it. |
PIXOO_SIZEOptional | Display size in pixels: 16, 32, or 64. Must match the physical device. |
PIXOO_OUTPUT_DIROptional | Directory for auto-saving preview PNG and GIF files. When unset, previews are returned in-response only. |
PIXOO_PUSH_MIN_INTERVAL_MSOptional | Minimum interval between device pushes in milliseconds. Prevents device freeze from rapid-fire commands. |
PIXOO_SERVE_HOSTOptional | Host advertised in the URL the device downloads an animation of more than 40 frames from, for NAT or a DNS name. When unset, the local address the OS routes to PIXOO_IP; the listener binds that address either way. |
PIXOO_SERVE_PORTOptional | Fixed port for the listener the device downloads an animation of more than 40 frames from, for firewall rules. When unset, a free port. |
PIXOO_BROWSER_PATHOptional | Browser executable for HTML rendering, such as the chrome-headless-shell that `npx @puppeteer/browsers install chrome-headless-shell@stable --path <dir>` installs. When set, the only browser tried: a path that is not an executable file fails rather than falling back. When unset, the newest chrome-h… |
PIXOO_HTML_ENABLEDOptional | Offer pixoo_render_html. false (or 0, no, off) disables it, removing it from tools/list; unset or true keeps it. A value that is not one of those boolean spellings fails startup. |
MCP_LOG_LEVELOptional | Sets the minimum log level for output (e.g., 'debug', 'info', 'warn'). |
Details
| Package | @cyanheads/[email protected] (NPM, stdio) |
| Package | @cyanheads/[email protected] (NPM, streamable-http) |
| First published | 29 Oct 2026 |
| Last updated | 29 Oct 2026 |
| Registry name | io.github.cyanheads/pixoo-mcp-server |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.