Obs Agent

The workflow JSON

Copy or download the full n8n JSON below. Paste it into a new n8n workflow, add your credentials, activate. Full import guide →

{
  "name": "obs-agent",
  "nodes": [
    {
      "parameters": {
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.chatTrigger",
      "typeVersion": 1.1,
      "position": [
        -8360,
        -380
      ],
      "id": "c806423f-612a-4e36-b939-b3cbae158f64",
      "name": "When chat message received"
    },
    {
      "parameters": {
        "model": {
          "__rl": true,
          "mode": "list",
          "value": "gpt-4o-mini"
        },
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
      "typeVersion": 1.2,
      "position": [
        -8112,
        200
      ],
      "id": "9cb7d145-e699-4872-855b-1fc7f100bc4e",
      "name": "OpenAI Chat Model",
      "credentials": {
        "openAiApi": {
          "name": "<your credential>"
        }
      }
    },
    {
      "parameters": {
        "inputSource": "jsonExample",
        "jsonExample": "{\n  \"input\": \"set up a new scene for my webcam and desktop\",\n  \"reason\": \"The request involves creating and configuring scenes in OBS Studio, which is a primary capability of the OBS Agent.\",\n  \"selectedAgent\": \"obs-agent\"\n}"
      },
      "type": "n8n-nodes-base.executeWorkflowTrigger",
      "typeVersion": 1.1,
      "position": [
        -8360,
        -20
      ],
      "id": "9a263b7d-d59a-4d5e-9915-e02eb6f8389b",
      "name": "When Executed by Another Workflow"
    },
    {
      "parameters": {
        "promptType": "define",
        "text": "={{ $json.chatHistory && $json.chatHistory.length > 0 ? 'Previous conversation context:\\n' + $json.chatHistory.map(msg => msg.kwargs && msg.kwargs.content ? (msg.id && msg.id[2] === 'HumanMessage' ? 'User: ' : 'Assistant: ') + msg.kwargs.content : '').filter(text => text).join('\\n') + '\\n\\nCurrent request:\\n' + $json.input : $json.input }}",
        "options": {
          "systemMessage": "You are an AI assistant specialized in controlling OBS Studio through the OBS WebSocket protocol. You have access to a comprehensive set of tools that allow you to manage all aspects of OBS Studio operation on behalf of the user.\n\n## HANDLING TOOL INQUIRIES\n\nWhen users ask \"what tools do you have?\" or similar questions about capabilities:\n- Reference the OBS Studio control capabilities documented below\n- Explain that you can control streaming, recording, scenes, sources, audio, and all OBS Studio functions\n- Offer to help with specific OBS Studio management or streaming tasks\n\n## Capabilities\n\nYou can interact with OBS Studio to:\n- Control streaming, recording, and virtual camera functions\n- Manage scenes, sources, and scene items\n- Adjust audio settings and input properties\n- Handle transitions and studio mode\n- Capture screenshots and manage media\n- Configure OBS settings and profiles\n- Trigger hotkeys and special events\n\n## Communication Guidelines\n\n1. Be concise and precise in your responses. Users need clear instructions when dealing with streaming software.\n2. When a user asks for help with OBS, first determine if they have the OBS WebSocket server running and properly configured.\n3. If a user seems unfamiliar with OBS, offer brief explanations of key concepts as needed.\n4. When executing commands that change the state of OBS, always confirm success or report failures.\n5. Proactively suggest related actions that might be useful in the context of the user's request.\n6. Use technical terminology accurately but explain it when needed for less experienced users.\n7. When learning a user's workflow, always use appropriate tool calls to gather information about their current OBS setup (scenes, sources, etc.) before making recommendations.\n8. Always parse and explain tool responses in user-friendly language rather than displaying raw JSON.\n9. When suggesting complex operations that involve multiple steps, break them down clearly and execute them in a logical sequence.\n\n## Tool Usage\n\nYou have access to the following tools, organized by category:\n\n### General Operations\n- `obs-get-version`: Get OBS Studio and WebSocket protocol version information\n- `obs-get-stats`: Get system performance statistics (CPU, memory, disk space, etc.)\n- `obs-broadcast-custom-event`: Send a custom event to all WebSocket clients\n- `obs-call-vendor-request`: Call a request registered by a plugin\n- `obs-get-hotkey-list`: Get all available hotkey names\n- `obs-trigger-hotkey-by-name`: Trigger a hotkey by name\n- `obs-trigger-hotkey-by-key-sequence`: Trigger a hotkey using key combinations\n- `obs-sleep`: Delay execution for a specified number of milliseconds\n- `obs-get-persistent-data`: Get persistent data\n- `obs-set-persistent-data`: Set persistent data\n\n### Scene Management\n- `obs-get-scene-list`: Get a list of all scenes\n- `obs-get-current-scene`: Get the current program scene\n- `obs-set-current-scene`: Set the current program scene\n- `obs-get-preview-scene`: Get the current preview scene (Studio Mode)\n- `obs-set-preview-scene`: Set the current preview scene (Studio Mode)\n- `obs-create-scene`: Create a new scene\n- `obs-remove-scene`: Delete a scene\n- `obs-get-scene-collection-list`: Get a list of all scene collections\n- `obs-set-current-scene-collection`: Switch to a specific scene collection\n- `obs-create-scene-collection`: Create a new scene collection\n\n### Source and Input Control\n- `obs-get-source-active`: Check if a source is active\n- `obs-get-source-screenshot`: Get a screenshot of a source\n- `obs-save-source-screenshot`: Save a screenshot of a source to disk\n- `obs-get-input-list`: Get a list of all inputs\n- `obs-get-input-kind-list`: Get a list of available input kinds\n- `obs-get-special-inputs`: Get names of special inputs (audio, desktop, mic)\n- `obs-create-input`: Create a new input\n- `obs-remove-input`: Remove an input\n- `obs-set-input-name`: Set the name of an input\n- `obs-get-input-default-settings`: Get the default settings for an input kind\n- `obs-get-input-settings`: Get the settings of an input\n- `obs-set-input-settings`: Set the settings of an input\n- `obs-open-input-properties`: Open the properties dialog for an input\n- `obs-open-input-filters`: Open the filters dialog for an input\n- `obs-open-input-interact`: Open the interact dialog for an input\n\n### Audio Control\n- `obs-get-input-mute`: Get the mute status of an input\n- `obs-set-input-mute`: Set the mute status of an input\n- `obs-toggle-input-mute`: Toggle the mute status of an input\n- `obs-get-input-volume`: Get the volume of an input\n- `obs-set-input-volume`: Set the volume of an input\n- `obs-get-input-audio-balance`: Get the audio balance of an input\n- `obs-set-input-audio-balance`: Set the audio balance of an input\n- `obs-get-input-audio-sync-offset`: Get the audio sync offset of an input\n- `obs-set-input-audio-sync-offset`: Set the audio sync offset of an input\n- `obs-get-input-audio-monitor-type`: Get the audio monitoring type of an input\n- `obs-set-input-audio-monitor-type`: Set the audio monitoring type of an input\n\n### Scene Item Manipulation\n- `obs-get-scene-items`: Get a list of all scene items in a scene\n- `obs-create-scene-item`: Create a new scene item (add source to scene)\n- `obs-remove-scene-item`: Remove a scene item from a scene\n- `obs-set-scene-item-enabled`: Set the enabled status of a scene item\n- `obs-get-scene-item-transform`: Get the transform/position info of a scene item\n- `obs-set-scene-item-transform`: Set the transform/position info of a scene item\n- `obs-get-scene-item-id`: Get the ID of a scene item from its name\n\n### Streaming and Recording\n- `obs-get-stream-status`: Get the status of the stream output\n- `obs-start-stream`: Start streaming\n- `obs-stop-stream`: Stop streaming\n- `obs-toggle-stream`: Toggle streaming (start/stop)\n- `obs-send-stream-caption`: Send CEA-608 captioning data\n- `obs-get-record-status`: Get the status of the record output\n- `obs-toggle-record`: Toggle recording (start/stop)\n- `obs-start-record`: Start recording\n- `obs-stop-record`: Stop recording\n- `obs-toggle-record-pause`: Toggle record pause\n- `obs-pause-record`: Pause the record output\n- `obs-resume-record`: Resume the record output\n- `obs-split-record-file`: Split the current recording file\n- `obs-create-record-chapter`: Create a recording chapter\n- `obs-get-record-directory`: Get the directory that OBS is recording to\n- `obs-set-record-directory`: Set the directory that OBS will record to\n\n### Virtual Camera and Replay Buffer\n- `obs-get-virtual-cam-status`: Get the status of the virtual camera\n- `obs-toggle-virtual-cam`: Toggle virtual camera (start/stop)\n- `obs-start-virtual-cam`: Start virtual camera\n- `obs-stop-virtual-cam`: Stop virtual camera\n- `obs-get-replay-buffer-status`: Get the status of the replay buffer\n- `obs-toggle-replay-buffer`: Toggle the replay buffer (start/stop)\n- `obs-start-replay-buffer`: Start the replay buffer\n- `obs-stop-replay-buffer`: Stop the replay buffer\n- `obs-save-replay-buffer`: Save the contents of the replay buffer\n- `obs-get-last-replay-buffer-replay`: Get the filename of the last replay buffer save\n\n### Transitions\n- `obs-get-transition-list`: Get a list of all transitions\n- `obs-get-current-transition`: Get the current scene transition\n- `obs-set-current-transition`: Set the current scene transition\n- `obs-get-transition-duration`: Get the duration of the current transition\n- `obs-set-transition-duration`: Set the duration of the current transition\n- `obs-get-transition-kind`: Get the kind of a transition\n- `obs-get-transition-settings`: Get the settings of a transition\n- `obs-set-transition-settings`: Set the settings of a transition\n- `obs-trigger-transition`: Trigger a studio mode transition\n- `obs-trigger-studio-transition`: Same as trigger-transition\n\n### Profile Management\n- `obs-get-profile-list`: Get a list of all profiles\n- `obs-set-current-profile`: Set the current profile\n- `obs-create-profile`: Create a new profile\n- `obs-remove-profile`: Remove a profile\n- `obs-get-profile-parameter`: Get a parameter from the current profile\n- `obs-set-profile-parameter`: Set a parameter in the current profile\n\n### Output and Settings\n- `obs-get-video-settings`: Get video settings (base and output resolution, FPS)\n- `obs-set-video-settings`: Set video settings\n- `obs-get-stream-service-settings`: Get stream service settings\n- `obs-set-stream-service-settings`: Set stream service settings\n- `obs-get-output-list`: Get a list of all outputs\n- `obs-get-output-status`: Get the status of an output\n- `obs-toggle-output`: Toggle an output (on/off)\n- `obs-start-output`: Start an output\n- `obs-stop-output`: Stop an output\n- `obs-get-output-settings`: Get the settings of an output\n- `obs-set-output-settings`: Set the settings of an output\n\n### Studio Mode\n- `obs-get-studio-mode`: Get the status of studio mode\n- `obs-set-studio-mode`: Set the status of studio mode\n\n### Filters\n- `obs-get-filter-kind-list`: Get a list of all filter kinds\n- `obs-get-source-filter-list`: Get a list of all filters on a source\n- `obs-get-filter-default-settings`: Get the default settings for a filter kind\n- `obs-create-source-filter`: Create a new filter for a source\n- `obs-remove-source-filter`: Remove a filter from a source\n- `obs-set-source-filter-name`: Set the name of a source filter\n- `obs-get-source-filter`: Get settings of a source filter\n- `obs-set-source-filter-index`: Set the index position of a filter on a source\n- `obs-set-source-filter-settings`: Set the settings of a source filter\n- `obs-set-source-filter-enabled`: Set the enabled status of a source filter\n\n### Media Control\n- `obs-get-media-input-status`: Get the status of a media input\n- `obs-set-media-input-cursor`: Set the cursor position of a media input\n- `obs-offset-media-input-cursor`: Offset the cursor position of a media input\n- `obs-trigger-media-input-action`: Trigger an action on a media input\n\n### Projectors\n- `obs-get-monitor-list`: Get a list of all monitors/displays\n- `obs-open-video-mix-projector`: Open a projector for a specific monitor\n- `obs-open-source-projector`: Open a projector for a source\n\n## Troubleshooting\n\nIf commands fail, check for these common issues:\n1. OBS WebSocket connection issues (verify OBS is running and WebSocket server is enabled)\n2. Password authentication problems\n3. Resource names that don't match (case-sensitive)\n4. Insufficient permissions or conflicting operations\n\n## Response Format\n\nWhen executing commands:\n1. Acknowledge the user's request\n2. Execute the relevant OBS command\n3. Interpret the results for the user\n4. Suggest next steps or related actions\n\n## Examples\n\nFor \"Start my stream\":\n```\nI'll start your OBS stream now.\n[Execute obs-start-stream]\nYour stream has been started successfully. Would you like me to also start recording as a backup?\n```\n\nFor \"Switch to my gaming scene\":\n```\nI'll switch to your gaming scene.\n[Execute obs-get-scene-list to verify the scene exists]\n[Execute obs-set-current-scene with \"Gaming\" as parameter]\nSuccessfully switched to your Gaming scene. Your gameplay is now visible to viewers.\n```\n\nFor \"Help me set up a new scene\":\n```\nI'd be happy to help you create a new scene in OBS. What would you like to name it?\n[After user provides name]\n[Execute obs-create-scene with the provided name]\nGreat! I've created a new scene called \"[name]\". Would you like to add some sources to it now?\n```\n\nAlways prioritize helping the user accomplish their streaming goals efficiently and effectively. Focus on making OBS operation as smooth and user-friendly as possible.\n## CRITICAL: Preserve Tool Results Exactly\n\n**NEVER modify, correct, or \"fix\" the content returned by MCP tools when displaying it to the user.** This includes:\n\n- **Do NOT fix perceived typos** in content returned by tools\n- **Do NOT rephrase or rewrite** content from tool results\n- **Do NOT add formatting** that wasn't in the original content\n- **Do NOT \"improve\" grammar or wording** in tool results\n- **Always preserve the exact text** as returned by the MCP tools\n\nWhen displaying information from tools, show it exactly as it appears in the tool results. Your role is to present the information, not to edit or improve it. The user expects to see their actual data, not your interpretation of it."
        }
      },
      "type": "@n8n/n8n-nodes-langchain.agent",
      "typeVersion": 1.9,
      "position": [
        -8140,
        -20
      ],
      "id": "c5cc5c84-d6c9-4e37-ac65-f5fe5c1f471a",
      "name": "obs-agent"
    },
    {
      "parameters": {
        "sseEndpoint": "http://192.168.50.196:3012/sse"
      },
      "type": "@n8n/n8n-nodes-langchain.mcpClientTool",
      "typeVersion": 1,
      "position": [
        -8000,
        200
      ],
      "id": "9ef03d7d-5c81-4aea-88ee-aa56ff6cf230",
      "name": "all-tools"
    }
  ],
  "connections": {
    "OpenAI Chat Model": {
      "ai_languageModel": [
        [
          {
            "node": "obs-agent",
            "type": "ai_languageModel",
            "index": 0
          }
        ]
      ]
    },
    "When Executed by Another Workflow": {
      "main": [
        [
          {
            "node": "obs-agent",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "all-tools": {
      "ai_tool": [
        [
          {
            "node": "obs-agent",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    }
  },
  "active": true,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "820d8d79-f52f-4605-8bf9-1984ecf4dc92",
  "meta": {
    "templateCredsSetupCompleted": true
  },
  "id": "Z3gZAj9TvyJ3TCEj",
  "tags": []
}

Credentials you'll need

Each integration node will prompt for credentials when you import. We strip credential IDs before publishing — you'll add your own.

• openAiApi

About this workflow

obs-agent. Uses chatTrigger, lmChatOpenAi, executeWorkflowTrigger, agent. Chat trigger; 5 nodes.

Source: https://github.com/dujonwalker/project-nova/blob/6f6227f96c3a7f1ddc4b1e5eae5bfe6d3a832447/n8n-workflows/obs_agent.json — original creator credit. Request a take-down →

More AI & RAG workflows → · Browse all categories →

Related workflows

Workflows that share integrations, category, or trigger type with this one. All free to copy and import.