An MCP server that lets an AI assistant (Claude, etc.) control OBS Studio through obs-websocket v5.
It exposes OBS scenes, sources, streaming, recording, virtual camera and screenshots as MCP tools, plus a raw escape hatch for any obs-websocket request not covered by a dedicated tool.
- OBS Studio 28+ (obs-websocket v5 is built in)
- Node.js 18+
- WebSocket server enabled in OBS: Tools → obs-websocket Settings → Enable WebSocket server
npm install
npm run buildSet these environment variables if your OBS instance isn't on the default local address, or if it has a password set:
| Variable | Default | Description |
|---|---|---|
OBS_WS_URL |
ws://127.0.0.1:4455 |
obs-websocket server URL |
OBS_WS_PASSWORD |
(empty) | obs-websocket server password |
Add it to your client's MCP server config, e.g. for Claude Code / Claude Desktop:
{
"mcpServers": {
"obs-studio": {
"command": "node",
"args": ["C:/path/to/obs-mcp/dist/index.js"],
"env": {
"OBS_WS_URL": "ws://127.0.0.1:4455",
"OBS_WS_PASSWORD": "your-password"
}
}
}
}Status
obs_get_status— version info, stats (cpu/fps/render times), stream/record/virtual-cam state
Scenes
obs_list_scenes— list scenes and the active oneobs_set_current_scene— switch the program sceneobs_create_scene— create a new empty scene
Scene items
obs_list_scene_items— list sources placed in a sceneobs_set_scene_item_enabled— show/hide a source inside a scene
Inputs (sources)
obs_list_inputs— list input sources, optionally filtered by kindobs_get_input_settings/obs_set_input_settings— read/patch an input's settingsobs_set_text_source— shortcut to update a text source's contentobs_set_input_mute/obs_toggle_input_mute— mute controlobs_set_input_volume— set volume in dB or as a multiplier
Streaming / Recording / Virtual cam
obs_start_stream/obs_stop_stream/obs_get_stream_statusobs_start_record/obs_stop_record/obs_pause_record/obs_resume_record/obs_get_record_statusobs_start_virtualcam/obs_stop_virtualcam
Screenshot
obs_take_screenshot— capture a source or scene and save it to disk
Escape hatch
obs_raw_request— call any obs-websocket v5 request type directly (filters, transitions, replay buffer, studio mode, profiles, scene collections, etc.)
npm run build # compile TypeScript to dist/
npm start # run the compiled server over stdioMIT