obs MCP Server

Use This MCP server To

Switch camera scenes while my hands are busy Start and stop my recording just by asking Mute or unmute my microphone in the middle of a stream Reposition and resize the overlays in a scene Check whether my stream is dropping frames Capture a still image of what a camera is showing

README

OBS MCP Server

An MCP server for OBS Studio that provides tools to control OBS via the OBS WebSocket protocol.

Features

Connect to OBS WebSocket server
Control OBS via MCP tools
Provides tools for:
- General operations
- Scene management
- Source control
- Scene item manipulation
- Streaming and recording
- Transitions

Usage

Make sure OBS Studio is running with WebSocket server enabled (Tools > WebSocket Server Settings). Note the password for the WS.
Set the WebSocket password in environment variable (if needed):

export OBS_WEBSOCKET_PASSWORD="your_password_here"

Add the MCP server to Claude desktop with the MCP server settings:

{
  "mcpServers": {
    "obs": {
      "command": "npx",
      "args": ["-y", "obs-mcp@latest"],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
      }
    }
  }
}

Use Claude to control your OBS!

Development

If you want to run the server locally using the code in this git repo, you can do the following:

npm run build
npm run start

Then configure Claude desktop:

{
  "mcpServers": {
    "obs": {
      "command": "node",
      "args": [
        "<obs-mcp_root>/build/index.js"
      ],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
      }
    }
  }
}

Available Tools

The server provides tools organized by category:

General tools: Version info, stats, hotkeys, studio mode
Scene tools: List scenes, switch scenes, create/remove scenes
Source tools: Manage sources, settings, audio levels, mute/unmute
Scene item tools: Manage items in scenes (position, visibility, etc.)
Streaming tools: Start/stop streaming, recording, virtual camera
Transition tools: Set transitions, durations, trigger transitions

Environment Variables

OBS_WEBSOCKET_URL: WebSocket URL (default: ws://localhost:4455)
OBS_WEBSOCKET_PASSWORD: Password for authenticating with OBS WebSocket (if required)

Requirements

Node.js 16+
OBS Studio 31+ with WebSocket server enabled
Claude desktop

License

See the LICENSE file for details.

obs-mcp FAQ

Do I need a key or a paid account?

No. The only credential is the password shown in OBS's own WebSocket Server Settings panel, and it never leaves your computer.

Can I use this to start my stream without touching the mouse?

Yes. Starting, stopping and toggling streaming, recording, the replay buffer and the virtual camera are all covered.

Does OBS have to be open?

Yes. OBS Studio 31 or newer must be running with its WebSocket server enabled, otherwise every command comes back as an error.

Can it delete my scenes or settings?

Yes. Removing scenes, sources, filters and entire profiles runs immediately with no confirmation, so be specific about what you ask for.

Which apps does it work in?

The setup instructions cover Claude Desktop, and the same config block is the standard format other desktop assistants accept.

Is it actively maintained?

The code has not been touched since August 2025. It still works against current OBS releases, but do not expect quick fixes.

Does it work over the internet?

It points at your own machine by default. Pointing it elsewhere means sending your OBS password across the network, which is not recommended.