real-browser-mcp
by ofershap·★ 20·Score 43
MCP server + Chrome extension enabling AI agents to control real browser sessions with existing logins and cookies.
Overview
Real Browser MCP is a powerful MCP server that bridges the gap between AI coding assistants and real browser environments. It consists of two main components: an MCP server that runs locally and communicates with AI clients, and a Chrome extension that executes commands in the browser. The solution allows AI agents to interact with existing browser sessions, preserving cookies, login states, and authentication. This eliminates the need for repeated login flows and enables AI agents to verify their work directly in the user's browser.
Try asking AI
After installing, here are 6 things you can ask your AI assistant:
When to choose this
Choose this when your AI agent needs to interact with your authenticated browser sessions without re-authentication or when you need to maintain state between AI actions.
When NOT to choose this
Don't choose this for headless browser automation scenarios where you don't need a visual browser or if you're looking for a cross-browser solution beyond Chrome.
Tools this server exposes
12 tools extracted from the READMEbrowser_snapshotAccessibility tree with element refs. Compact mode returns only interactive elements
browser_screenshotCapture what's on screen
browser_textExtract raw text from page or element
browser_findQuery elements by CSS selector
browser_clickClick by ref or CSS selector
browser_click_textClick by visible text. Works through React portals and overlays
browser_typeType into inputs and contenteditable fields
browser_press_keyKey combos (Enter, Escape, Ctrl+A)
browser_scrollScroll pages and virtual containers
browser_navigateGo to a URL in the active tab
browser_tabsList, create, close, or focus tabs
browser_consoleConsole output (log, warn, error)
Comparable tools
Installation
Installation
1. Add the MCP server
**Cursor (one click):** [<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" height="32" />](cursor://anysphere.cursor-deeplink/mcp/install?name=real-browser&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInJlYWwtYnJvd3Nlci1tY3AiXX0=)
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:** Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Add the same JSON block.
2. Install the Chrome extension
[<img src="https://developer.chrome.com/static/docs/webstore/branding/image/iNEddTyWiMfLSwFD6qGq.png" alt="Available in the Chrome Web Store" height="58" />](https://chromewebstore.google.com/detail/real-browser-mcp/fkkimpklpgedomcheiojngaaaicmaidi)
Or load from source:
git clone https://github.com/ofershap/real-browser-mcp.git
cd real-browser-mcp
open chrome://extensions
# Enable Developer mode (toggle in top right)
# Click Load unpacked and select the extension/ folder3. Teach Your Agent
Run one command:
npx real-browser-mcp --setup cursorThis installs agent rules and browser checking commands.
FAQ
- Does it work with my logged-in sessions?
- Yes, that's the whole point. The extension runs inside your actual Chrome with the same cookies, sessions, and local storage. No re-authentication needed.
- Does it send data anywhere?
- No. The MCP server and extension communicate over WebSocket on localhost. Nothing leaves your machine. There's no analytics, telemetry, or cloud component.
Compare real-browser-mcp with
Last updated · Auto-generated from public README + GitHub signals.