pixoo-mcp-server — Claude Code MCP server: how to install
Sends pixel layouts, text feeds, and browser renders to Divoom Pixoo displays across the local network. Useful for physical status boards and desktop art.
claude mcp add --env PIXOO_IP=<PIXOO_IP> --env PIXOO_SIZE=<PIXOO_SIZE> --env PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> --env PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> --env PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> --transport stdio pixoo-mcp-server -- npx -y @cyanheads/pixoo-mcp-serverWhat pixoo-mcp-server does
The server connects AI clients to Pixoo-64, 16, and 32 hardware. It provides eight tools and four resources. Agents can scan local IP addresses through Divoom discovery, inspect device status, and adjust hardware brightness or active channels.
Visual rendering covers multiple approaches. Dedicated text tooling switches between three built-in fonts and scales words down to avoid clipping. The scene composer stacks up to 50 distinct layers, combining shapes, sparklines, images, and sprites. An integrated headless browser renders SVG, Canvas, and HTML markups frame by frame.
Push calls fail immediately if the client cannot reach the panel IP on the local network.
What it helps with
- push real-time project metrics to a physical LED matrix
- format text with automatic font scaling and scrolling
- render HTML, SVG, and Canvas graphics for a 64x64 screen
- adjust brightness, channels, and clock faces remotely
Example prompts for the agent
- Display the current build status on my Pixoo screen using the neon theme
- Show a clock on the LED matrix with numerals font at 60 percent brightness
- Build a dashboard scene with sparkline and text using
pixoo_compose_scene
How to install pixoo-mcp-server
Platform CLI
claude mcp add --env PIXOO_IP=<PIXOO_IP> --env PIXOO_SIZE=<PIXOO_SIZE> --env PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> --env PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> --env PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> --transport stdio pixoo-mcp-server -- npx -y @cyanheads/pixoo-mcp-serverReplace <…> with your own values. 9 more environment variables are in the server README
Platform CLI
codex mcp add pixoo-mcp-server --env PIXOO_IP=<PIXOO_IP> --env PIXOO_SIZE=<PIXOO_SIZE> --env PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> --env PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> --env PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> -- npx -y @cyanheads/pixoo-mcp-serverReplace <…> with your own values. 9 more environment variables are in the server README
Config file
{
"mcpServers": {
"pixoo-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/pixoo-mcp-server"
],
"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>"
}
}
}
}Replace <…> with your own values. 9 more environment variables are in the server README
Config file
{
"servers": {
"pixoo-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/pixoo-mcp-server"
],
"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>"
}
}
}
}Replace <…> with your own values. 9 more environment variables are in the server README
Platform CLI
gemini mcp add -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> pixoo-mcp-server npx -y @cyanheads/pixoo-mcp-serverReplace <…> with your own values. 9 more environment variables are in the server README
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 pixoo-mcp-server
How to install pixoo-mcp-server in Claude Code?
Run the terminal command: claude mcp add pixoo-mcp-server -- npx -y @cyanheads/pixoo-mcp-server.
Which Divoom Pixoo panels can this server drive?
Pixoo-64 serves as the main resolution target, but Pixoo-16 and Pixoo-32 matrix units are supported as well.
How does text rendering handle characters missing from a font?
The standard and compact fonts substitute unrecognized characters with question marks and report their code points. The numerals font strictly accepts digits with select symbols and rejects any unlisted characters during validation.
