Log inSubmit server
Pixoo MCP Server logo

Pixoo MCP Server

Render text, scenes, images, and animations on Divoom Pixoo LED displays through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Pixoo MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "pixoo-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/pixoo-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The pixoo-mcp-server MCP server connects AI clients to Divoom Pixoo LED displays on a local network. It renders styled text, layered scenes, images, and animations, while also exposing tools for overlays, device state, discovery, and display-design guidance. Use it when an agent needs to create or update content on Pixoo-64, Pixoo-16, or Pixoo-32 hardware. It supports stdio and local Streamable HTTP operation.

Use cases

  • Display status dashboards on a Pixoo panel
  • Render announcements and scrolling text
  • Push pixel-art images and animations
  • Compose animated scenes with widgets and icons
  • Control brightness, channels, and screen state

Key features

  • Styled text rendering with themes and auto-fit
  • Layered scene composition with animation
  • Local and HTTPS image pushing
  • Device-native scrolling text overlays
  • Pixoo discovery and device-state control
  • Pixel-display design guidance

Tools8

What Pixoo MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~217 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

5/5 checks healthy over the last 35d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · @cyanheads/pixoo-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads94MPackage downloads in the last 30 days.
Last commit25d agoMost recent push to the default branch.
Tools exposed8Callable tools this server registers over MCP.

How Pixoo MCP Server works

What the pixoo-mcp-server MCP server does

The pixoo-mcp-server MCP server sends generated content to Divoom Pixoo LED matrix displays over a local network. Pixoo-64 is the primary target, with Pixoo-16 and Pixoo-32 also supported. Agents can create display-ready text, compose multi-layer scenes, resize and push image assets, manage device-native scrolling text, and read or change device settings.

The server also includes a design-brief tool that supplies pixel-display guidance and current device context. Its guidance covers legibility, palette use, layout zones, animation limits, themes, and icons. The repository documents four resources for device status, themes, icons, and the display design guide.

How it works

Content is rendered before it is sent to the display. Text supports themes, palette ramps, gradients, shadows, outlines, alignment, semantic or pixel positions, and automatic fitting. Text can be static or animated with scrolling, floating, or pulsing effects. The renderer reports fitting decisions and returns the rendered result as an image.

Scene composition draws up to 50 elements back-to-front. Supported element types include text, icons, geometric shapes, progress indicators, sparklines, bitmaps, pixels, images, and sprites. Elements can use opacity, blending, gradients, themes, and animation presets or keyframes. Longer animations may be delivered as a GIF that the device downloads from the server host.

Image pushes accept an absolute local path or an HTTPS URL. Sources are resized to the LED grid and can use contain, cover, or fill fitting. Animated GIF and WebP sources are handled as animations, with frame and speed controls. Palette reduction can use a generated color set or a supplied palette, with optional dithering.

Setup and configuration

The pixoo-mcp-server MCP server can run as a stdio process or as a local Streamable HTTP server. The README provides installation links for Claude Desktop, Cursor, and VS Code, including an npx-based configuration for supported clients. Pixoo devices need to be reachable on the local network.

Run device discovery during setup to obtain Pixoo device IP addresses. Discovery uses Divoom's cloud discovery endpoint, while display operations target the device on the local network. The device-control tool can read status without parameters and can change brightness, screen state, channel, or clock face.

Tools and capabilities

  • pixoo_display_text renders and pushes styled or animated text.
  • pixoo_compose_scene builds layered static or animated scenes.
  • pixoo_push_image resizes and pushes local or HTTPS image sources.
  • pixoo_overlay_text sets or clears a device-rendered scrolling overlay.
  • pixoo_control_device reads or changes supported device state.
  • pixoo_discover_devices finds Pixoo devices and their LAN addresses.
  • pixoo_design_brief returns design advice and live device context.

Limitations and notes

Text fonts have defined character sets. Unsupported characters may be replaced or cause validation failure, depending on the selected font. A single line that remains wider than the panel can be cut off unless an applicable scrolling effect is used. Scene elements are placed as supplied and are not automatically refit to the panel.

HTTPS image downloads are capped at 10 MB. Invalid paths, undecodable assets, unknown icons, invalid colors, and invalid output paths produce typed errors. Animation settings have bounded frame and speed ranges, and device-native overlay text remains active across channel changes until it is cleared.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pixoo MCP Server

pixoo-mcp-server is an MCP server that connects AI clients to Divoom Pixoo LED displays on a local network. Its main tools render text, compose scenes, push images, manage scrolling overlays, control device state, discover devices, and provide pixel-display design guidance.

Install it through the README's client-specific links for Claude Desktop, Cursor, or VS Code, or use the provided npx-based configuration. The server can run as stdio or as a local Streamable HTTP server.

Yes, pixoo-mcp-server has a Cursor installation link in its README. Cursor can configure the server using the supplied npx command and package name.

Use the `pixoo_discover_devices` tool during setup. It searches through Divoom's cloud discovery endpoint and returns Pixoo devices and their LAN IP addresses for subsequent local-network operations.

Yes, `pixoo_push_image` treats decodable animated GIF and WebP sources as animations. It can sample frames up to the configured limit, preserve or set playback timing, and send longer animations as a GIF for the device to download.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPixoo MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/pixoo-mcp-server?style=directory)](https://allmcps.com/mcp/pixoo-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/pixoo-mcp-server"><img src="https://allmcps.com/api/badge/pixoo-mcp-server?style=directory" alt="Pixoo MCP Server on AllMCPs" /></a>