# MCP Browser Extension

An MCP server that points your agent at the Chrome window you already have open, sessions and cookies included. Useful where a site has no API.

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

## What it does

There are two pieces here: a Chrome extension and a small MCP server started with `npx` (package and command `mcp-browser-extension`). Grab the extension from the Chrome Web Store or load it unpacked. The server listens on a local WebSocket, the extension dials in, and tabs are driven through `chrome.scripting` and `chrome.tabs`. No separate Chromium is launched, so nothing works until the extension is in place.

Nothing is reachable until you say so. With no flags the agent reads zero pages. Hosts open up one at a time — `--allow-domain mail.google.com --allow-domain github.com` — and `*.example.com` also covers subdomains. Reads are checked, not just clicks, and the extension enforces the same rule on its end. Page changes, `eval`, downloads and uploads each need their own opt-in. Password fields never come back in a read, and `--redact` strips tokens, API keys and JWTs.

The agent works in background tabs, so the page in front of you is not navigated or clicked away; one `batch` call can pull several tabs at once. Every call lands in an audit log with the URL, the verdict and the size of the response. Access can be cut from the popup or Settings, and the block holds after a restart. An expired session returns `[AUTH_REQUIRED]` rather than a vague timeout. Credentials are never stored, and the server does not sign in for you.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-browser-extension -- npx -y mcp-browser-extension
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-browser-extension -- npx -y mcp-browser-extension
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-browser-extension npx -y mcp-browser-extension
```

## When to use it
- read a Gmail thread in a tab you are already signed into
- go through pull requests and settings on a private GitHub repo
- pull numbers off a dashboard that has no API
- keep the agent inside one allowed domain
- read several open tabs in a single call

## Example prompts
- Open the analytics dashboard tab and pull the revenue table for last month
- Read the latest Gmail thread and summarize what they are asking for
- Walk the open pull requests on GitHub and list the ones waiting on my review

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 12927

---
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