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

npm install
npm run build

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):

export OBS_WEBSOCKET_PASSWORD="your_password_here"

Run the OBS MCP server to see that it is able to build and connect:

npm run build
npm run start

Provision you Claude desktop with the MCP server settings:

{
  "mcpServers": {
    "obs": {
      "command": "node",
      "args": [
        "<obs-mcp_root>/build/index.js"
      ],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
      }
    }
  }
}

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

MCPControl
claude-did-this
-
security
A
license
-
quality
A Windows control server built using nut.js and Model Context Protocol (MCP), providing programmatic control over Windows system operations including mouse, keyboard, window management, and screen capture functionality.
Last updated -
109
152
TypeScript
MIT License
MCP Proxy Sidecar
dortegau
-
security
A
license
-
quality
A modified JetBrains MCP Server that adds WebSocket monitoring capabilities, allowing users to monitor MCP tool calls in real-time while maintaining compatibility with the original implementation.
Last updated -
JavaScript
Apache 2.0
Computer Control MCP
AB498
-
security
A
license
-
quality
MCP server that provides computer control capabilities including mouse movements, keyboard actions, screenshot capture with OCR, and window management through a unified API.
Last updated -
4
Python
MIT License
MCP SSH Agent
AiondaDotCom
-
security
A
license
-
quality
A 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 -
157
2
JavaScript
MIT License

View all related MCP servers

Appeared in Searches

A platform or tools for creating music

OBS MCP Server

OBS MCP Server

Features

Installation

Usage

Available Tools

Environment Variables

Requirements

License

Related MCP Servers

MCPControl

MCP Proxy Sidecar

Computer Control MCP

MCP SSH Agent

Appeared in Searches

New MCP Servers

MCP directory API