Pixoo MCP Server

by cyanheadsio.github.cyanheads/pixoo-mcp-serverv1.4.0

Render and push styled pixel art, text, dashboards, and animations to Divoom Pixoo LED displays.

10Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install Pixoo MCP server

claude mcp add pixoo -- npx -y @cyanheads/pixoo-mcp-server run start:stdio

{
  "mcpServers": {
    "pixoo": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/pixoo-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "pixoo": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/pixoo-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "pixoo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/pixoo-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "pixoo": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/pixoo-mcp-server",
        "run",
        "start:stdio"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PIXOO_IP	—	—	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_SIZE	—	—	Display size in pixels: 16, 32, or 64. Must match the physical device.
PIXOO_OUTPUT_DIR	—	—	Directory for auto-saving preview PNG and GIF files. When unset, previews are returned in-response only.
PIXOO_PUSH_MIN_INTERVAL_MS	—	—	Minimum interval between device pushes in milliseconds. Prevents device freeze from rapid-fire commands.
PIXOO_SERVE_HOST	—	—	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_PORT	—	—	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_PATH	—	—	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-headless-shell in Puppeteer's cache (~/.cache/puppeteer).
PIXOO_HTML_ENABLED	—	—	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_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.

Freshness

Active — last maintenance signal 12d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
2026-09-27 · 12d ago · GitHub · v1.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-27 · 12d ago · official registry · v1.4.0

FAQ

›How do I install the Pixoo MCP server in Claude Code?

Run: claude mcp add pixoo -- npx -y @cyanheads/pixoo-mcp-server run start:stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Pixoo require an API key?

No required environment variables are declared in its published metadata.

›Can I use Pixoo as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Pixoo in the official MCP registry?

Yes, as io.github.cyanheads/pixoo-mcp-server.