# pixoo-mcp-server

Sends pixel layouts, text feeds, and browser renders to Divoom Pixoo displays across the local network. Useful for physical status boards and desktop art.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/pixoo-mcp-server
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/pixoo-mcp-server

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PIXOO_IP`, `PIXOO_SIZE`, `PIXOO_OUTPUT_DIR`, `PIXOO_PUSH_MIN_INTERVAL_MS`, `PIXOO_SERVE_HOST`, `PIXOO_SERVE_PORT`, `PIXOO_BROWSER_PATH`, `PIXOO_HTML_ENABLED`, `MCP_LOG_LEVEL`, `MCP_TRANSPORT_TYPE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 9 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 9 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 9 more environment variables are in the server README

## When to use it
- 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
- 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`

## Similar
- [Divoom LAN Watchface](https://affpapa.org/en/nevibecode/mcp/divoom-lan-watchface.md) — MCP server · ★ 7
- [codex-pet](https://affpapa.org/en/nevibecode/skills/codex-pet.md) — skill · 401100 installs
- [Home Assistant Automation](https://affpapa.org/en/nevibecode/skills/home-assistant-automation.md) — skill · 4900 installs
- [layer-pixel-art](https://affpapa.org/en/nevibecode/skills/layer-pixel-art.md) — skill · 3400 installs
- [hatch-pet](https://affpapa.org/en/nevibecode/skills/nexu-io-hatch-pet.md) — skill · 3100 installs
- [8-bit-orbit-video-template](https://affpapa.org/en/nevibecode/skills/8-bit-orbit-video-template.md) — skill · 2800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md