Overview
What is OBS MCP Server?
OBS MCP Server is an MCP server that connects to OBS Studio via the OBS WebSocket protocol, allowing AI assistants like Claude to control OBS programmatically. It is intended for users who want to automate scene management, source control, streaming, recording, and transitions from within an MCP-compatible client.
How to use OBS MCP Server?
Ensure OBS Studio is running with its WebSocket server enabled (Tools > WebSocket Server Settings). Note the WebSocket password, then set it as the environment variable OBS_WEBSOCKET_PASSWORD. Add the server to Claude desktop’s MCP configuration using npx -y obs-mcp@latest and provide the password. Restart Claude and issue commands to control OBS.
Key features of OBS MCP Server
- Connect to OBS WebSocket server with password authentication.
- Control general operations (version info, stats, hotkeys, studio mode).
- Manage scenes: list, switch, create, remove.
- Manage sources: settings, audio levels, mute/unmute.
- Manipulate scene items: position, visibility, etc.
- Start/stop streaming, recording, and virtual camera.
Use cases of OBS MCP Server
- Automate scene transitions during a live stream.
- Switch sources or adjust audio levels via natural language commands.
- Record or broadcast without manually clicking through OBS menus.
- Integrate OBS control into a larger AI‑powered production workflow.
FAQ from OBS MCP Server
What does OBS MCP Server do?
It provides a set of MCP tools that let Claude (or other MCP clients) control OBS Studio—such as switching scenes, managing sources, and controlling streaming or recording.
What are the requirements?
Node.js 16+, OBS Studio 31+ with the WebSocket server enabled, and an MCP client like Claude desktop.
How do I set the WebSocket password?
Set the environment variable OBS_WEBSOCKET_PASSWORD to the password you configured in OBS’s WebSocket Server Settings. You can also optionally set OBS_WEBSOCKET_URL (default is ws://localhost:4455).
What tools are available?
Tools are organized by category: General (version, stats, hotkeys), Scene (list, switch, create, remove), Source (settings, audio, mute), Scene Item (position, visibility), Streaming (start/stop recording/streaming/virtual cam), and Transition (set transitions, durations, trigger).
Does the server store any data or require internet access?
The README does not mention data storage or internet access; it connects locally to OBS via WebSocket. Authentication is handled via a password set in environment variables.
