Real Browser MCP

by ofershap

500 downloads
Not rated
GitHub

About

MCP server + Chrome extension that gives AI coding agents control of your real browser with existing sessions and logins. Works with Cursor, Claude, Windsurf, and any MCP client.

Details

Author
ofershap
Downloads
500
Categories
Automation, AI, Developer Tools

- Navigate, click, type, scroll, and take screenshots
- Read page text and accessibility snapshots
- Execute JavaScript in page context
- Handle dialogs, monitor console and network
- Manage tabs

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Real Browser MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the server globally via npx real-browser-mcp and install the companion Chrome extension from the Chrome Web Store. No further configuration is needed to start controlling your browser with AI agent prompts.

browser_navigate

Navigate to a URL in the active browser tab

browser_click

Click an element on the page using a ref from snapshot or a CSS selector

browser_type

Type text into an input element

browser_scroll

Scroll the page or an element. Supports pixel offsets, scrolling to elements, and named positions (top/bottom). Works with virtual scroll containers used by social media sites.

browser_press_key

Press a keyboard key or combination (Enter, Escape, Tab, ArrowDown, etc). Supports modifiers like Ctrl+A, Cmd+C.

browser_wait

Wait for a condition: element to appear, element to disappear, or a fixed delay. Useful for SPAs and dynamic content.

browser_snapshot

Get an accessibility tree snapshot of the page. Returns element refs you can use with click, type, and other tools. Use compact mode (default) for smaller output - only interactive elements.

browser_screenshot

Capture a screenshot of the visible page area

browser_console

Read console messages (log, warn, error) from the browser

browser_network

Read network requests made by the page. Filter by URL pattern.

browser_tabs

Manage browser tabs: list, create, close, or focus

browser_find

Find elements on the page using natural language (e.g. "login button", "search input"). Returns refs you can use with click/type.

browser_text

Extract raw text content from the page or a specific element

browser_hover

Hover over an element to trigger tooltips, dropdown menus, or hover states

browser_select

Select an option from a dropdown/select element

browser_evaluate

Execute JavaScript in the page and return the result. Use for DOM queries, reading page state, or any operation not covered by other tools.

browser_click_text

Click an element by its visible text content. Works on React dropdowns, portals, and overlays that may not appear in snapshots. CSP-safe (no eval). Prefers deepest matching element.

browser_handle_dialog

Handle JavaScript dialogs (alert, confirm, prompt). Dialogs block page interaction until handled.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Real Browser MCP

Give your AI agent eyes on your real browser. MCP server + Chrome extension that lets AI coding agents (Cursor, Claude, Windsurf) interact with your actual browser — the one you already have open with all your sessions, logins, and cookies.

Why?

Unlike Playwright MCP or Chrome DevTools MCP that launch a fresh headless browser, Real Browser MCP works with your actual browser. No re-authentication. No replaying login flows.

Features

- Navigate, click, type, scroll, take screenshots - Read page text and accessibility snapshots - Execute JavaScript in page context - Handle dialogs, monitor console and network - Manage tabs

Install

`` npx real-browser-mcp `` Chrome extension: Chrome Web Store GitHub | npm
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.