New:Microsoft Teams Notifications Are Now Available in Socket.Learn more
Get Started

weboperator-mcp

Package Overview
Dependencies
Maintainers
1
Versions
2
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

weboperator-mcp

Hands your live Chrome tab to any MCP client — snapshot, navigate, click, type, extract.

latest
Source
npmnpm
Version
1.5.1
Version published
Weekly downloads
29
-40.82%
Maintainers
1
Weekly downloads
 
Created
Source

weboperator-mcp

MCP server that hands your live Chrome tab to any agent client — Claude Desktop, Cursor, Hermes, OpenClaw, OpenHands. Speaks MCP over stdio.

It drives the browser you are already signed into, so your sessions, cookies, and extensions come along. Nothing is launched headless and nothing leaves the machine.

Tools

browser_snapshot · browser_navigate · browser_click · browser_type · browser_press · browser_scroll · browser_screenshot · browser_extract · browser_solve_captcha · weboperator_execute_goal

browser_snapshot returns an accessibility tree with numbered interactive elements; the action tools take those numbers, so an agent never guesses at CSS selectors.

Install

The server talks to Chrome through the WebOperator extension and a Native Messaging host, so install the extension first, then register the host:

npx -p weboperator-mcp weboperator-bridge-install

Then point your client at the server:

{
  "mcpServers": {
    "weboperator": {
      "command": "npx",
      "args": ["-y", "weboperator-mcp"]
    }
  }
}

Reload the extension in chrome://extensions after registering the host.

Configuration

VariableDefaultWhat it does
WEBOPERATOR_BRIDGE_PORT8765Port of the local bridge HTTP API
WEBOPERATOR_BRIDGE_HOST127.0.0.1Bridge bind address
WEBOPERATOR_AGENT_SOCKET/tmp/weboperator-bridge.sockUnix socket the bridge listens on
WEBOPERATOR_API_TOKEN(unset)Shared token, required when unauthenticated bridge access is disabled

macOS and Linux. Chrome, Chromium, Brave, Edge, and Arc are all registered by the installer.

Security

Page content is treated as data, never as instructions — the extension's prompt-injection fixtures live in evals/fixtures/. browser_solve_captcha pauses for you rather than defeating a challenge, and login flows stop for a human instead of typing credentials.

MIT © Artem KK · full documentation

Keywords

mcp

FAQs

Package last updated on 01 Sep 2026

Related posts