---
title: "@n8n/mcp-browser"
description: "MCP server that gives AI agents full control over Chrome. Connects to the user's real installed browser via the **n8n AI Browser Bridge** extension, using their actual profile, cookies, and sessions. Action tools return an accessibility snapshot with every response for single-roundtrip interaction."
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/readme-520
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:36:38.436Z
license: CC-BY-4.0
attribution: "@n8n/mcp-browser — Claudary (https://claudary.paisolsolutions.com/skills/readme-520)"
---

# @n8n/mcp-browser
MCP server that gives AI agents full control over Chrome. Connects to the user's real installed browser via the **n8n AI Browser Bridge** extension, using their actual profile, cookies, and sessions. Action tools return an accessibility snapshot with every response for single-roundtrip interaction.

## Overview

# @n8n/mcp-browser

MCP server that gives AI agents full control over Chrome. Connects to the
user's real installed browser via the **n8n AI Browser Bridge** extension, using
their actual profile, cookies, and sessions. Action tools return an
accessibility snapshot with every response for single-roundtrip interaction.

See [spec/browser-mcp.md](spec/browser-mcp.md) for the full feature spec and
[spec/technical-spec.md](spec/technical-spec.md) for the technical design.

## Usage

### Library mode

```typescript
import { createBrowserTools } from '@n8n/mcp-browser';

const { tools, connection } = createBrowserTools({
  defaultBrowser: 'chrome',
  headless: false,
  viewport: { width: 1280, height: 720 },
});

// Register tools on any MCP server
for (const tool of tools) {
  server.tool(tool.name, tool.description, tool.inputSchema, tool.execute);
}

// Cleanup on shutdown
process.on('SIGTERM', () => connection.shutdown());
```

### Standalone mode

```bash
# HTTP transport (default)
npx @n8n/mcp-browser --browser chrome --transport http --port 3100

# stdio transport
npx @n8n/mcp-browser --browser chrome --transport stdio
```

### CLI flags

| Flag | Alias | Env var | Default | Description |
|------|-------|---------|---------|-------------|
| `--browser` | `-b` | `N8N_MCP_BROWSER_DEFAULT_BROWSER` | `chrome` | Default browser |
| `--headless` | | `N8N_MCP_BROWSER_HEADLESS` | `false` | Headless mode |
| `--viewport` | | `N8N_MCP_BROWSER_VIEWPORT` | `1280x720` | Viewport (WxH) |
| `--transport` | `-t` | `N8N_MCP_BROWSER_TRANSPORT` | `http` | `http` or `stdio` |
| `--port` | `-p` | `N8N_MCP_BROWSER_PORT` | `3100` | HTTP port |

CLI flags take precedence over environment variables.

## Prerequisites

1. **Chrome** (or Brave/Edge) installed
2. **n8n AI Browser Bridge** extension loaded in Chrome:
   - Open `chrome://extensions`
   - Enable Developer mode
   - Click "Load unpacked" and select the `mcp-browser-extension` directory

## Testing with AI clients

Start the server:

```bash
npx @n8n/mcp-browser --transport http --port 3100
```

Or from the monorepo:

```bash
npx tsx packages/@n8n/mcp-browser/src/server.ts --transport http --port 3100
```

Then point your client at `http://localhost:3100/mcp`:

<details>
<summary>Claude Desktop</summary>

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`
(macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "n8n-browser": {
      "url": "http://localhost:3100/mcp"
    }
  }
}
```

</details>

<details>
<summary>Claude Code</summary>

Add to `.mcp.json` in your project root (per-project) or
`~/.claude/mcp.json` (global):

```json
{
  "mcpServers": {
    "n8n-browser": {
      "url": "http://localhost:3100/mcp"
    }
  }
}
```

Or add interactively with `/mcp add`.

</details>

<details>
<summary>Cursor</summary>

Add to `.cursor/mcp.json` in your project root:

```json
{
  "mcpServers": {
    "n8n-browser": {
      "url": "http://localhost:3100/mcp"
    }
  }
}
```

</details>

<details>
<summary>Windsurf</summary>

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "n8n-browser": {
      "url": "http://localhost:3100/mcp"
    }
  }
}
```

</details>

<details>
<summary>VS Code (GitHub Copilot)</summary>

Add to `.vscode/mcp.json` in your project root. Note: VS Code uses `"servers"`
instead of `"mcpServers"`.

```json
{
  "servers": {
    "n8n-browser": {
      "url": "http://localhost:3100/mcp"
    }
  }
}
```

</details>

## Development

```bash
pnpm dev    # start standalone MCP server with hot reload
pnpm build  # build for production
pnpm test   # run tests
```

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/readme-520) · https://claudary.paisolsolutions.com