OBS MCP Server logo

OBS MCP Server

by royshil

An MCP server for OBS Studio that provides tools to control OBS via the OBS WebSocket protocol. It enables users to manage and automate various aspects of OBS Studio using MCP tools.

View on GitHub

Last updated: N/A

What is OBS MCP Server?

OBS MCP Server is a tool that allows users to control OBS Studio programmatically via the OBS WebSocket protocol. It acts as a bridge, enabling external applications or services (like Claude) to interact with OBS and automate tasks.

How to use OBS MCP Server?

  1. Ensure OBS Studio is running with the WebSocket server enabled. 2. Set the WebSocket password if required. 3. Install and build the OBS MCP server using npm. 4. Run the server. 5. Configure your application (e.g., Claude) with the server settings to enable control of OBS.

Key features of OBS MCP Server

  • Connects to OBS WebSocket server

  • Provides tools for general operations, scene management, source control, scene item manipulation, streaming/recording, and transitions

  • Allows remote control of OBS Studio

  • Enables automation of OBS tasks

Use cases of OBS MCP Server

  • Automating scene switching during a live stream

  • Remotely controlling source visibility and audio levels

  • Triggering transitions between scenes

  • Starting and stopping streaming or recording via external commands

FAQ from OBS MCP Server

What is the default WebSocket URL?

The default WebSocket URL is ws://localhost:4455.

What environment variables are required?

The OBS_WEBSOCKET_PASSWORD environment variable is required if your OBS WebSocket server has a password set.

What are the minimum requirements?

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

How do I install the server?

Run npm install followed by npm run build.

How do I start the server?

Run npm run start after building the server.