Skip to main content
MCP server CX Codex

OSCAR — Claude Code MCP server: what it does, how to install

Connects your OSCAR installation to an AI assistant: it reads projects, widgets, ports, and drafts control interfaces. Never publishes or changes anything itself.

BSD-3-Clause ★ 196 updated 2026-10-24

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add oscar -- npx -y createwithoscar
Open on GitHub

What OSCAR does

The server gives an AI assistant access to your OSCAR installation — the editor for OSC, MIDI and DMX control interfaces. The assistant sees all projects, every widget's configuration, MIDI port list, and message history. It can sketch an interface: that draft shows up in OSCAR with a Draft badge, and you decide whether to open and publish it.

The server never sends anything to your rig, never publishes, and never edits existing projects. Needs OSCAR version 2.1 or newer running locally, with the MCP toggle in the top bar green. On Windows you may need Node 18 or later.

It reaches OSCAR through a file OSCAR writes at startup (~/.oscar/mcp.json): that file holds the address and a token that refreshes every time. Switch the MCP toggle off in OSCAR and the server loses access.

What it helps with

  • diagnose why a control does not respond to commands
  • draft an interface with faders and buttons for a lighting desk
  • inspect widget configuration and MIDI port settings
  • see what messages OSCAR recently sent and received
  • build a control panel for show software or instruments

Example prompts for the agent

  • Draft a four-fader interface with a blackout button for my lighting console
  • Why isn't this fader controlling the fixture?
  • Show me all widget settings in the current OSCAR project

How to install OSCAR

Platform CLI

claude mcp add oscar -- npx -y createwithoscar

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 OSCAR

How to install OSCAR in Claude Code?

Run claude mcp add oscar -- npx -y createwithoscar. OSCAR version 2.1 or newer must be running locally, with the MCP toggle in the top bar green.

What does the OSCAR MCP server do?

It gives an AI assistant access to your OSCAR installation: the assistant reads projects, widget settings, MIDI ports, message history, and can draft an interface. It does not publish or alter projects on its own.

What do I need to run OSCAR?

OSCAR version 2.1 or newer running locally with the MCP toggle enabled (green button in the top bar). On Windows you may need Node 18 or later.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open