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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OBS MCP Serverswitch to my gaming scene"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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):
Add the MCP server to Claude desktop with the MCP server settings:
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:
Then configure Claude desktop:
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.