How to add Real Browser MCP to Windsurf

Give AI agents control of your real Chrome browser with existing sessions, cookies, and logins. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 33★ · stdio · no auth

Windsurf config for Real Browser MCP

npx -y real-browser-mcp

{
  "mcpServers": {
    "real-browser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "real-browser-mcp"
      ]
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Real Browser MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Real Browser MCP's tools become available to Cascade.

Before you start

Node.js with npx available (for the MCP server)
Google Chrome with the Real Browser MCP extension installed (from the Chrome Web Store or loaded unpacked from the extension/ folder)
An MCP-compatible client such as Cursor, Claude Desktop, Claude Code, Windsurf, or Cline

What Real Browser MCP can do in Windsurf

browser_snapshot

Capture the accessibility tree with element refs; compact mode (default) returns only interactive elements.

browser_screenshot

Capture what is currently on screen.

browser_text

Extract raw text from the page or a specific element.

browser_find

Query elements by CSS selector.

browser_click

Click an element by ref or CSS selector.

browser_click_text

Click by visible text; works through React portals and overlays.

browser_type

Type into inputs and contenteditable fields.

browser_press_key

Send key combos such as Enter, Escape, or Ctrl+A.

Security

Everything stays local: the MCP server and Chrome extension communicate over WebSocket on localhost only. No cloud component, no analytics, no telemetry. Because the extension runs inside your actual Chrome, the agent inherits all of your logged-in sessions and can act on any site you are authenticated to, so grant access only to agents you trust.

Real Browser MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Real Browser MCP config there under the "mcpServers" key and restart the client.

Is Real Browser MCP safe to use with Windsurf?

Does it work with my logged-in sessions?

Yes, that is the whole point. The extension runs inside your actual Chrome with the same cookies, sessions, and local storage, so no re-authentication is needed.

Does it send data anywhere?

No. The MCP server and extension talk over WebSocket on localhost. Nothing leaves your machine, and there is no analytics, telemetry, or cloud component.

Which AI clients work?

Any MCP-compatible client, including Cursor, Claude Desktop, Claude Code, Windsurf, and Cline.

View repo Full Real Browser MCP page