Real Browser MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add real-browser-mcp -- npx -y real-browser-mcp
README.md

The missing piece in AI coding: your agent can now see your REAL browser.

real-browser-mcp

The missing piece in AI coding: your agent can now see your REAL browser.

 

 

 


You ship a fix. Your agent says "done, please verify." You alt-tab to Chrome, navigate to the page, log in, click around, find the bug.

Your agent just wrote the code. It could also verify it. It already has your browser open right there. It just can't see it.

Now it can.


Quick Start

Two parts:

  • MCP server - runs on your machine, talks to your AI agent
  • Chrome extension - sits in your browser, executes the commands

1. Add the MCP server

Cursor (one click):

Or add manually in Cursor Settings > MCP > "Add new MCP server":

{
  "mcpServers": {
    "real-browser": {
      "command": "npx",
      "args": ["-y", "real-browser-mcp"]
    }
  }
}
Claude Desktop, Windsurf, or other MCP clients

Claude Desktop: Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Add the same JSON block.

Windsurf: Settings > MCP. Same config.

Any MCP-compatible client works.

2. Install the Chrome extension

Or load from source:

git clone https://github.com/ofershap/real-browser-mcp.git
  1. Open chrome://extensions and enable Developer mode (toggle in the top right)
  2. Click Load unpacked and select the extension/ folder from the cloned repo

Click the Real Browser MCP icon in your toolbar.

Green dot = connected. Gray = waiting for server.

Done. Your agent can see your browser.


How Others Compare

Real Browser MCP Playwright MCP Chrome DevTools MCP
Uses your existing browser Yes No, launches new Partial, needs debug port
Sessions and cookies Already there Fresh profile Manual setup
Works behind corporate SSO Yes No Depends
Setup Extension + MCP config Headless browser Chrome with --remote-debugging-port

🧠 Teach Your Agent

The agent can use all 18 tools out of the box, but it works better when it knows when and how to chain them. A config file teaches the right workflow - snapshot first, then act, then verify.

Run one command:

npx real-browser-mcp --setup cursor

This installs:

  • `~/.curso

Tools (4)

navigateNavigate the browser to a specific URL
clickClick an element on the current page
typeType text into an input field
snapshotTake a screenshot and get the accessibility tree of the current page

Configuration

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

Try it

Take a snapshot of the current page to see what is on my screen.
Navigate to github.com and log in to my account.
Click the submit button on the current form.
Type 'AI agents' into the search bar and press enter.

Frequently Asked Questions

What are the key features of Real Browser MCP?

Uses your existing browser sessions, logins, and cookies. Works behind corporate SSO. Provides 18 tools for browser interaction. Compatible with Cursor, Claude Desktop, and Windsurf. Includes a Chrome extension for real-time browser control.

What can I use Real Browser MCP for?

Verifying code fixes by navigating to the local development URL in your browser. Automating repetitive web tasks that require existing authenticated sessions. Debugging web applications by having the AI agent inspect the live DOM. Performing end-to-end testing using your actual browser profile.

How do I install Real Browser MCP?

Install Real Browser MCP by running: npx -y real-browser-mcp

What MCP clients work with Real Browser MCP?

Real Browser MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Real Browser MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare