Broadcasting / CONNECTION GUIDE

OBS Studio MCP Servers for Claude Code & Cursor

Connect OBS scenes, sources, audio and recording through its official WebSocket API or community MCP bridges.

Integration documentation

OBS Studio integrations and connections

API · Live app

OBS WebSocket API

The official remote-control API, usable by a custom script or agent bridge.

Platforms: Windows, macOS, Linux

Claude Code · Not documented

A custom client script or bridge is required; agent-specific setup is not listed.

Codex · Not documented

A custom client script or bridge is required; agent-specific setup is not listed.

Cursor · Not documented

A custom client script or bridge is required; agent-specific setup is not listed.

Requirements and limitations

OBS with WebSocket enabled, authenticated connection, and a separate client script or bridge.

This is a WebSocket API. Connecting an AI agent requires a client script or an additional MCP bridge.

View setup Maintainer documentation

MCP · Live app

OBS MCP · Node bridge

A Node.js MCP bridge maps OBS WebSocket operations to agent-callable tools.

Platforms: See documentation

Claude Code · MCP compatible

MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.

Codex · MCP compatible

MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.

Cursor · MCP compatible

MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.

Requirements and limitations

OBS Studio with WebSocket enabled and the Node.js bridge configured with connection credentials.

Requires a reachable OBS WebSocket server; it does not replace OBS or configure streaming service accounts.

View setup Maintainer documentation

MCP · Live app

OBS MCP · Python bridge

A Python MCP server connects scene, source, audio and output controls to OBS WebSocket.

Platforms: Windows, macOS, Linux

Claude Code · Documented

The maintainer documents Claude Code setup for this connection.

Codex · MCP compatible

MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.

Cursor · Documented

The maintainer documents Cursor setup for this connection.

Requirements and limitations

Python 3.10+ and OBS Studio 28+ with WebSocket v5 enabled and connection settings configured.

The WebSocket connection must be active. Output availability depends on the OBS configuration and installed sources.

View setup Maintainer documentation

Compare connections

Compare how each route works, what it can do, and what you need to run it.

Connection	Workflow and platform	Capabilities	Documented agents	Requirements and limitations
OBS WebSocket API API	Live app Windows, macOS, Linux	Inspect scenes Switch program scene Start and stop recording	See compatibility	OBS with WebSocket enabled, authenticated connection, and a separate client script or bridge. This is a WebSocket API. Connecting an AI agent requires a client script or an additional MCP bridge.
OBS MCP · Node bridge MCP	Live app See documentation	Manage scenes and sources Control recording and streaming	See compatibility	OBS Studio with WebSocket enabled and the Node.js bridge configured with connection credentials. Requires a reachable OBS WebSocket server; it does not replace OBS or configure streaming service accounts.
OBS MCP · Python bridge MCP	Live app Windows, macOS, Linux	Manage sources, scenes and audio Control streaming and recording	Claude Code, Cursor	Python 3.10+ and OBS Studio 28+ with WebSocket v5 enabled and connection settings configured. The WebSocket connection must be active. Output availability depends on the OBS configuration and installed sources.

OBS WebSocket API

How it works
API · Live app
Windows, macOS, Linux

Capabilities
Inspect scenes · Switch program scene · Start and stop recording

Documented agents
See compatibility

Requirements and limitations

OBS with WebSocket enabled, authenticated connection, and a separate client script or bridge.

This is a WebSocket API. Connecting an AI agent requires a client script or an additional MCP bridge.

OBS MCP · Node bridge

How it works
MCP · Live app
See documentation

Capabilities
Manage scenes and sources · Control recording and streaming

Documented agents
See compatibility

Requirements and limitations

OBS Studio with WebSocket enabled and the Node.js bridge configured with connection credentials.

Requires a reachable OBS WebSocket server; it does not replace OBS or configure streaming service accounts.

OBS MCP · Python bridge

How it works
MCP · Live app
Windows, macOS, Linux

Capabilities
Manage sources, scenes and audio · Control streaming and recording

Documented agents
Claude Code · Cursor

Requirements and limitations

Python 3.10+ and OBS Studio 28+ with WebSocket v5 enabled and connection settings configured.

The WebSocket connection must be active. Output availability depends on the OBS configuration and installed sources.

Get started

Connect OBS Studio with MCP

Choose an AI agent

Claude Code + OBS Studio

Codex: setup not listed in the integration documentation.

Cursor + OBS Studio

Questions before setup

Does one integration cover every workflow?

No such claim is made. Check the capability list, requirements and limitations of each route, then test a copy of a representative project.