Browser Extension

Give Claude a browser.

A Chrome extension that connects Claude Code to your browser via DevTools Protocol. Click, type, navigate, screenshot — 10 automation commands with trusted input events.

Browser automation without the bloat

No Puppeteer. No Selenium. No headless browser eating your RAM. browser-bridge-ext talks directly to the tab you already have open through Chrome DevTools Protocol.

Claude Code connects to the extension over a local WebSocket, gets real DOM access, and dispatches trusted input events — the same kind the browser generates when you actually click and type.

claude> navigate to github.com and star the repo
Navigating to github.com/softwaresoftware-dev/claude-browser-bridge-extension...
Page loaded. Finding the star button...
Clicking [★ Star]...
Done. Repository starred.

How it works

1

Install the extension

Load browser-bridge-ext into Chrome or Brave. It runs quietly in the background, waiting for a connection from the MCP server.

2

Start the MCP server

Add claude-browser-bridge to your Claude Code config. The MCP server connects to the extension over WebSocket on localhost:7225.

3

Automate anything

Ask Claude to interact with any page. It can click elements, fill forms, take screenshots, run JavaScript, and navigate between pages.

The extension uses exponential backoff reconnection with keepalive pings, so the connection stays solid even if the MCP server restarts.

What you get

10 browser commands

Navigate, click, type, scroll, screenshot, eval JS, get page content, get element info, fill forms, and wait for elements. Everything you need for real browser automation.

Chrome DevTools Protocol

Dispatches trusted input events through CDP — the same mechanism Chrome uses internally. Sites can't distinguish these from real user interactions.

WebSocket on localhost

The extension connects to the MCP server on localhost:7225. No cloud services, no API keys, no data leaving your machine. Everything stays local.

Resilient connection

Exponential backoff reconnection with keepalive pings. If the MCP server restarts or the connection drops, the extension reconnects automatically.

Get started

Two pieces: the browser extension and the MCP server.

1
Clone and install the extension
git clone https://github.com/softwaresoftware-dev/claude-browser-bridge-extension.git
2
Load as unpacked extension
chrome://extensions → Developer mode → Load unpacked
3
Add the MCP server to Claude Code
claude mcp add browser-bridge npx claude-browser-bridge
4
Use it
claude "navigate to example.com and take a screenshot"