> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browseros.com/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n Integration

> Build AI workflows that control your browser

Connect BrowserOS to n8n to build automated workflows. Your n8n AI agents can control the browser—open pages, click buttons, extract data, and fill forms.

## What You Can Build

* **Lead enrichment** — Pull a list of LinkedIn URLs from a spreadsheet and scrape each profile
* **Price monitoring** — Check product prices hourly and send a Slack alert when they drop
* **Form automation** — Auto-fill job applications using data from your CRM
* **Data extraction** — Scrape authenticated pages that require login

## Prerequisites

Before you start:

* BrowserOS running with MCP server enabled (Settings → BrowserOS as MCP)
* n8n running locally (`npx n8n` or install globally with `npm install -g n8n`)

## Setup

### 1. Install the MCP community node

In n8n, go to **Settings → Community Nodes** and install `n8n-nodes-mcp`:

<img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/images/n8n-node.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=030978d8b6e8d60e90fa576b13614626" alt="Installing n8n-nodes-mcp community node" width="875" height="282" data-path="images/n8n-node.png" />

### 2. Create a workflow

Build a workflow with these nodes:

1. Add a **Chat Trigger** node (receives your messages)
2. Add an **AI Agent** node and connect it to the trigger
3. Add a **Chat Model** under the AI Agent (e.g., OpenAI, Claude)
4. Add an **MCP Client Tool** under the AI Agent

<img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/images/n8n-step3-workflow.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=e633426e04811ca7d6a9fdd28db905ee" alt="n8n workflow with AI Agent and MCP Client" width="2448" height="1834" data-path="images/n8n-step3-workflow.png" />

### 3. Configure the AI Agent

In the AI Agent node, set **Source for Prompt** to **Connected Chat Trigger Node**.

<img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/images/n8n-step4-agent-prompt.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=e0964f9d3f0769215f2c078a03a55f1c" alt="AI Agent prompt configuration" width="2448" height="1834" data-path="images/n8n-step4-agent-prompt.png" />

### 4. Connect to BrowserOS

Click on the MCP Client node and configure:

* **Endpoint**: Your BrowserOS MCP URL (find it in Settings → BrowserOS as MCP)
* **Server Transport**: `HTTP Streamable`

<img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/images/n8n-step5-mcp-client.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=934c67d72d1a057467326e4c4231649a" alt="MCP Client configuration with BrowserOS URL" width="2448" height="1834" data-path="images/n8n-step5-mcp-client.png" />

### 5. Test it

Save the workflow, click **Open chat**, and try:

```
open google.com in BrowserOS
```

<img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/images/n8n-step6-test.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=28c222f8258fcb13952a0ef7e53571c6" alt="Testing the workflow" width="2448" height="1834" data-path="images/n8n-step6-test.png" />

## Troubleshooting

If the connection fails:

* Make sure BrowserOS is running
* Check that MCP server is enabled in BrowserOS settings
* Verify the port number matches your BrowserOS MCP URL