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>"
      }
    }
  }
}

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.