# xenon-widgets

The xenon-widgets MCP server for Claude Code builds widgets for a Xenon dashboard. The agent can consult the SDK, install a widget, inspect runtime issues and view its tile screenshot.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 125 repo stars
- Author: marcimastro98
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/marcimastro98/Xenon/tree/HEAD/packages/mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/xenon-widgets

## What it does

The server gives an agent tools to create and manage Xenon widgets. It can fetch SDK sections, generate a starter folder with a manifest and web assets, install or update a widget, inspect its errors and permissions, and capture its tile on screen. It can also write out one of your own widgets for further editing or produce a share code.

Xenon 5.0.0 or newer must be running, and the server needs Node.js 18 or newer. The first tool call triggers a permission prompt in Xenon’s dashboard; widget permissions themselves remain under dashboard approval. Access is limited to the local computer and widgets you created. Tile screenshots do not work on Linux under Wayland.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add xenon-widgets -- npx -y xenon-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp -- npx -y xenon-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "xenon-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "xenon-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp npx -y xenon-mcp
```

## When to use it
- scaffold a Xenon widget from its SDK
- install a widget and inspect runtime issues
- view a widget tile as it appears on the dashboard
- write an existing personal widget to a folder for editing

## Example prompts
- Create a Xenon widget that shows CPU usage and save it in `cpu-tile`.
- Install the widget from `gpu-temp` and show me its tile screenshot.
- Inspect issues and permissions for my `weather-card` widget.

## Similar
- [workos-widgets](https://affpapa.org/en/nevibecode/skills/workos-widgets.md) — skill · 905 installs
- [wear-widgets](https://affpapa.org/en/nevibecode/skills/wear-widgets.md) — skill · 544 installs
- [widgets-ui](https://affpapa.org/en/nevibecode/skills/widgets-ui.md) — skill · 239 installs
- [makepad-2.0-widgets](https://affpapa.org/en/nevibecode/skills/makepad-20-widgets.md) — skill · ★ 754 repo stars
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 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
