nodriver — undetected browser automation MCP Server

Name: nodriver — undetected browser automation MCP Server
Author: io.github.andresolbach

io.github.andresolbach/nodriver-mcp-server

Repository Registry

What is the nodriver — undetected browser automation MCP server?

Undetected anti-bot Chrome automation. 65 tools, parallel isolated browsers.

How to install nodriver — undetected browser automation

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

NODRIVER_HEADLESS
Run Chrome headless (true/false). Default false.
NODRIVER_USER_DATA_DIR
Explicit persistent Chrome profile directory. Default: an ephemeral temp profile, auto-deleted per session.
NODRIVER_BROWSER_PATH
Path to the Chrome/Chromium executable. Auto-detected when unset.
NODRIVER_PROXY
Proxy server address passed to Chrome as --proxy-server.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nodriver-mcp-server": {
      "command": "uvx",
      "args": [
        "nodriver-mcp"
      ],
      "env": {
        "NODRIVER_HEADLESS": "<YOUR_NODRIVER_HEADLESS>",
        "NODRIVER_USER_DATA_DIR": "<YOUR_NODRIVER_USER_DATA_DIR>",
        "NODRIVER_BROWSER_PATH": "<YOUR_NODRIVER_BROWSER_PATH>",
        "NODRIVER_PROXY": "<YOUR_NODRIVER_PROXY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "nodriver-mcp-server": {
      "command": "uvx",
      "args": [
        "nodriver-mcp"
      ],
      "env": {
        "NODRIVER_HEADLESS": "<YOUR_NODRIVER_HEADLESS>",
        "NODRIVER_USER_DATA_DIR": "<YOUR_NODRIVER_USER_DATA_DIR>",
        "NODRIVER_BROWSER_PATH": "<YOUR_NODRIVER_BROWSER_PATH>",
        "NODRIVER_PROXY": "<YOUR_NODRIVER_PROXY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nodriver-mcp-server": {
      "command": "uvx",
      "args": [
        "nodriver-mcp"
      ],
      "env": {
        "NODRIVER_HEADLESS": "<YOUR_NODRIVER_HEADLESS>",
        "NODRIVER_USER_DATA_DIR": "<YOUR_NODRIVER_USER_DATA_DIR>",
        "NODRIVER_BROWSER_PATH": "<YOUR_NODRIVER_BROWSER_PATH>",
        "NODRIVER_PROXY": "<YOUR_NODRIVER_PROXY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "nodriver-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nodriver-mcp"
      ],
      "env": {
        "NODRIVER_HEADLESS": "<YOUR_NODRIVER_HEADLESS>",
        "NODRIVER_USER_DATA_DIR": "<YOUR_NODRIVER_USER_DATA_DIR>",
        "NODRIVER_BROWSER_PATH": "<YOUR_NODRIVER_BROWSER_PATH>",
        "NODRIVER_PROXY": "<YOUR_NODRIVER_PROXY>"
      }
    }
  }
}

Claude Code

claude mcp add nodriver-mcp-server --env NODRIVER_HEADLESS=<YOUR_NODRIVER_HEADLESS> --env NODRIVER_USER_DATA_DIR=<YOUR_NODRIVER_USER_DATA_DIR> --env NODRIVER_BROWSER_PATH=<YOUR_NODRIVER_BROWSER_PATH> --env NODRIVER_PROXY=<YOUR_NODRIVER_PROXY> -- uvx nodriver-mcp