# chrome-bridge

This MCP server lets an agent work in a tab from your signed-in Chrome. It fits browser forms, audits, and tasks where you take over for 2FA.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: frsorrentino
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/frsorrentino/chrome-bridge
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/chrome-bridge

## What it does

chrome-bridge connects Claude Code to a running Chrome session through a local WebSocket bridge. The agent can navigate pages, inspect the DOM, fill forms, locate elements, run audits, compare screenshots, and mock network responses. Tabs opened for the agent are kept separate from your own tabs.

When a page needs a human, `handoff` displays a banner and pauses the run. You can complete a login, enter 2FA, solve a CAPTCHA, answer a question, or select page elements, then let the agent continue. The setup needs Node.js 18+, Chrome 135+, and the Chrome Bridge extension loaded from `extension/` in developer mode.

On Windows, `install.sh` cannot run from PowerShell or cmd. Error-log hooks also need Python 3.8+ available as `python3`, `python`, or `py`; without it, the browser tools still work while those hooks stay quiet.

## Requirements
- Needs: Node.js (commands run via npx)
- Works with: Chrome

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add chrome-bridge -- npx -y chrome-bridge-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add chrome-bridge -- npx -y chrome-bridge-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chrome-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "chrome-bridge-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "chrome-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "chrome-bridge-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add chrome-bridge npx -y chrome-bridge-mcp
```

## When to use it
- work in a page where Chrome is already signed in
- fill a web form from supplied data
- run accessibility, SEO, or security audits
- locate an element in a large table
- pause for a human 2FA or CAPTCHA step

## Example prompts
- Fill the form in the current tab from `user.json`, then hand control to me for 2FA.
- Compare the page with the reference image using `screenshot_diff` and report the changes.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 13345

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md