How to add Real Browser MCP to Cursor

Give AI agents control of your real Chrome browser with existing sessions, cookies, and logins. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor config for Real Browser MCP

npx -y real-browser-mcp

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

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Real Browser MCP config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Real Browser MCP's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Real Browser MCP config there under the "mcpServers" key and restart the client.

Is Real Browser MCP safe to use with Cursor?

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