Utilizes Node.js as the runtime environment for the MCP server, with Node.js 16+ being a requirement for operation.
Connects to OBS Studio via the WebSocket protocol, providing tools for scene management, source control, streaming/recording control, transitions, and general operations in OBS.
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
Installation
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):
Run the OBS MCP server to see that it is able to build and connect:
Provision you Claude desktop with the MCP server settings:
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.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A server that provides tools to control OBS Studio remotely via the OBS WebSocket protocol, enabling management of scenes, sources, streaming, and recording through an MCP client interface.
Related MCP Servers
- -securityAlicense-qualityMCP server that provides computer control capabilities including mouse movements, keyboard actions, screenshot capture with OCR, and window management through a unified API.Last updated -48MIT License
- AsecurityAlicenseAqualityA server that enables secure interaction with remote SSH hosts through standardized MCP interface, providing functions like listing hosts, executing commands, and transferring files using native SSH tools.Last updated -77530MIT License
- -securityFlicense-qualityA minimal WebSocket-based MCP server implementation that enables modern tool integrations with VSCode, Claude, and other applications.Last updated -1
- AsecurityFlicenseAqualityA server based on the MCP framework that provides remote server management capabilities through SSH, supporting features like connection pooling, file transfers, and remote command execution.Last updated -7