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

Related MCP server: MCP SSH Agent

Installation

Usage

1. Make sure OBS Studio is running with WebSocket server enabled (Tools > WebSocket Server Settings). Note the password for the WS.

2. Set the WebSocket password in environment variable (if needed):

3. Run the OBS MCP server to see that it is able to build and connect:

4. Provision you Claude desktop with the MCP server settings:

5. Use Claude to control your 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.