Controls OBS Studio over the OBS WebSocket protocol to manage scenes, sources and streaming.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add obs --env OBS_WEBSOCKET_PASSWORD='<OBS_WEBSOCKET_PASSWORD>' -- npx -y obs-mcp@latest~/.codex/config.toml
[mcp_servers.obs]
command = "npx"
args = ["-y", "obs-mcp@latest"]
env = { OBS_WEBSOCKET_PASSWORD = "<OBS_WEBSOCKET_PASSWORD>" }
# codex mcp add obs --env OBS_WEBSOCKET_PASSWORD='<OBS_WEBSOCKET_PASSWORD>' -- npx -y obs-mcp@latest~/.cursor/mcp.json
{
"mcpServers": {
"obs": {
"command": "npx",
"args": [
"-y",
"obs-mcp@latest"
],
"env": {
"OBS_WEBSOCKET_PASSWORD": "<OBS_WEBSOCKET_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"obs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"obs-mcp@latest"
],
"env": {
"OBS_WEBSOCKET_PASSWORD": "<OBS_WEBSOCKET_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"obs": {
"command": "npx",
"args": [
"-y",
"obs-mcp@latest"
],
"env": {
"OBS_WEBSOCKET_PASSWORD": "<OBS_WEBSOCKET_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"obs": {
"command": "npx",
"args": [
"-y",
"obs-mcp@latest"
],
"env": {
"OBS_WEBSOCKET_PASSWORD": "<OBS_WEBSOCKET_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"obs": {
"command": "npx",
"args": [
"-y",
"obs-mcp@latest"
],
"env": {
"OBS_WEBSOCKET_PASSWORD": "<OBS_WEBSOCKET_PASSWORD>"
}
}
}
}Environment variables
OBS_WEBSOCKET_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.