Installation Guide · v1.1.5

Get set up in 5 steps.

Connect Claude Code to your browser. Claude can see, read, click, and control the active tab through a Chrome side panel — all from your terminal.

Requires Node.js 18+ Google Chrome Claude Code CLI
1
Install the package
Install BrowserConnect globally so it's available from any directory.
bash
$ npm install -g browserconnect
2
Register with Claude Code
Run this once. It registers BrowserConnect globally — the server starts automatically whenever Claude Code starts. No manual launch needed.
bash
$ claude mcp add -s user browser-connect browserconnect
✦ No manual server startup required. The BrowserConnect server runs automatically as long as Claude Code is open.
3
Install the Chrome extension
Download and load the extension into Chrome. One-time setup.
  • Download the extension zip: BrowserConnect.zip
  • Unzip it — you'll get a chrome-extension folder
  • Open Chrome and go to chrome://extensions
  • Enable Developer mode — toggle in the top-right corner
  • Click Load unpacked → select the chrome-extension folder
✦ The extension is not yet on the Chrome Web Store. Load it as an unpacked extension using the steps above.
4
Open the side panel
Open any webpage in Chrome, then open the BrowserConnect panel.
  • Click the Extensions icon (puzzle piece) in the Chrome toolbar
  • Click BrowserConnect to open the side panel
  • Wait for the green dot — it confirms the panel is connected to the server
5
Verify it works
Start or restart Claude Code, then ask it to take a screenshot.
claude
# In a Claude Code session
take a screenshot
✦ Claude should capture and display your current browser tab. If it times out, make sure the side panel is open and the green dot is visible.

You're set up.

BrowserConnect starts automatically with Claude Code. Daily workflow: open Chrome with the side panel visible, run claude in your terminal — the green dot appears and all browser tools are ready.

To update: npm install -g browserconnect, then reload the extension at chrome://extensions.

Back to browserconnect.net → View on npm

Using Cursor instead of Claude Code?

Create ~/.cursor/mcp.json with the following — Cursor will start the server automatically:

json
{
  "mcpServers": {
    "browser-connect": {
      "command": "browserconnect"
    }
  }
}