@alessai/mybrowser-mcp

Persistent Chrome automation for Claude Code and any MCP client.

This package is the server side of MyBrowser. It gives an MCP client access to a real browser with navigation, screenshots, extraction, console and network tooling, uploads, downloads, recording, replay, and multi-session coordination.

Important: installing this npm package is only half of the setup. You also need the MyBrowser Chrome extension.

Fastest Setup for Claude Code

claude mcp add mybrowser -- npx -y @alessai/mybrowser-mcp --host 0.0.0.0 --port 9009

Then install the Chrome extension from:

https://github.com/alessai/MyBrowser-MCP/releases/latest

If ~/.mybrowser/config.json has not been created yet, run claude mcp get mybrowser once to trigger the server and generate it.

Highlights

1. Browser control: tabs, navigation, clicks, typing, forms, hover, drag and drop, and keyboard input
2. Inspection: screenshots with interactive markers, ARIA snapshots, element search, and structured extraction
3. Debugging: console logs, page eval, storage inspection, network capture, performance metrics, and responsive viewport presets
4. Diagnostics: persistent server logs, redacted diagnostics, support bundles, and extension-side copy diagnostics
5. Workflow tools: uploads, downloads, clipboard support, waits, recording, replay, and saved site knowledge
6. Coordination: shared state, tab ownership, session management, locks, and event handlers

Install

npm install -g @alessai/mybrowser-mcp

Start

mybrowser-mcp --host 0.0.0.0 --port 9009

On first run, MyBrowser writes its config to:

~/.mybrowser/config.json

That file contains the shared auth token the Chrome extension needs.

Chrome Extension Required

After installing the npm package, download the Chrome extension from the GitHub Releases page:

https://github.com/alessai/MyBrowser-MCP/releases/latest

Then:

1. Unzip the extension
2. Open chrome://extensions
3. Enable Developer mode
4. Click Load unpacked
5. Select the unzipped folder
6. Enter the server address, port, and auth token in the extension popup

MCP Config Example

{
  "mcpServers": {
    "mybrowser": {
      "command": "mybrowser-mcp",
      "args": ["--host", "0.0.0.0", "--port", "9009"]
    }
  }
}

Diagnostics

Server logs are written to:

~/.mybrowser/logs/mybrowser-mcp.log
~/.mybrowser/logs/mybrowser-mcp-errors.log

Useful support tools:

1. browser_diagnostics - returns redacted server, browser, session, extension, and recent failure information
2. browser_support_bundle - writes a redacted support bundle under ~/.mybrowser/support-bundles/
3. browser_get_console_logs - returns browser page console logs
4. browser_network - captures and inspects network requests
5. browser_set_viewport / browser_reset_viewport - applies or clears iPhone, iPad, and desktop viewport emulation

If you already installed the package globally, the equivalent Claude Code command is:

claude mcp add mybrowser -- mybrowser-mcp --host 0.0.0.0 --port 9009

Repository

GitHub: https://github.com/alessai/MyBrowser-MCP