Browser Use
Lets AI do web tasks for you, such as filling forms, searching and extracting data, in the maker’s cloud browsers or on your computer.
Description from the maker (original English)
Hands your live Chrome tab to any MCP client — snapshot, navigate, click, type, extract.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
WEBOPERATOR_BRIDGE_PORT, WEBOPERATOR_AGENT_SOCKET, WEBOPERATOR_API_TOKENValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"weboperator": {
"command": "npx",
"args": [
"-y",
"weboperator-mcp"
],
"env": {
"WEBOPERATOR_BRIDGE_PORT": "your-value",
"WEBOPERATOR_AGENT_SOCKET": "your-value",
"WEBOPERATOR_API_TOKEN": "your-value"
}
}
}
}Run this in your terminal
claude mcp add weboperator --env WEBOPERATOR_BRIDGE_PORT=your-value --env WEBOPERATOR_AGENT_SOCKET=your-value --env WEBOPERATOR_API_TOKEN=your-value -- npx -y weboperator-mcpFill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"weboperator": {
"command": "npx",
"args": [
"-y",
"weboperator-mcp"
],
"env": {
"WEBOPERATOR_BRIDGE_PORT": "your-value",
"WEBOPERATOR_AGENT_SOCKET": "your-value",
"WEBOPERATOR_API_TOKEN": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"weboperator": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"weboperator-mcp"
],
"env": {
"WEBOPERATOR_BRIDGE_PORT": "your-value",
"WEBOPERATOR_AGENT_SOCKET": "your-value",
"WEBOPERATOR_API_TOKEN": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.
Your choice stays on this device in a cookie; no account needed.
WEBOPERATOR_BRIDGE_PORT envWEBOPERATOR_AGENT_SOCKET envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026
The registry name was verified with the GitHub account KazKozDev, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: WEBOPERATOR_API_TOKEN
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed –, and the latest version (1.5.1) reached the registry 2 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: Browser Use, Chrome DevTools MCP, MCP Server Browser
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Lets AI do web tasks for you, such as filling forms, searching and extracting data, in the maker’s cloud browsers or on your computer.
Lets AI use Chrome’s developer tools to inspect pages, find what makes them slow and spot errors. Made by the Chrome DevTools team.
MCP server for browser use access
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Tell Chrome what you want done, in plain English, and let the agent do it.
Most browser agents bring their own browser. WebOperator works the one you are already in: the tab in front of you, with your sessions and logins intact — no separate profile, no re-login, no copying cookies around. The model behind it can be local, served by Ollama or MLX, so the pages you look at never have to leave the machine. And it works in both directions: the local bridge exposes that same live tab over MCP, so Hermes, OpenClaw, or any other agent client can borrow your browser as a tool.
git clone https://github.com/KazKozDev/WebOperator.git
npm --prefix WebOperator/core ci npm --prefix WebOperator/core run build
Your goal, typed once · The agent plans, acts, verifies · Every step visible
Two ways in. If you would rather not touch Node, grab the weboperator-1.5.0-chrome.zip archive from the latest release and unzip it — that folder *is* the built extension.
If you ran the commands above instead, the build lands in core/dist and finishes in well under a second:
vite v8.0.11 building client environment for production...
✓ 101 modules transformed. ✓ built in 189ms
Either way, open chrome://extensions, enable Developer mode, click Load unpacked, and point it at the folder you just got. Press Cmd+Shift+K (Ctrl+Shift+K on Linux) to open the side panel, pick a provider under Settings, and type a goal.
Out of the box the agent talks to Ollama at http://127.0.0.1:11434, so have a tool-capable local model running before your first task — or paste an API key and use a remote provider instead.
WebOperator works the tab you are looking at in a plan → act → verify loop: it writes out a plan you can read, calls one browser tool at a time, and checks each result against a fresh snapshot of the page before moving on.
Summarize the current page
It can navigate, click, type, press keys, scroll, switch tabs, screenshot, and pull out structured text — so the same loop still works when the answer is scattered across half a dozen open tabs.
Compare info across tabs
The side panel streams the plan, every action, and the final answer, and keeps the full trace; history, checkpoints, and scheduled runs each get their own tab. The flip side: the agent only knows what it can actually see in the browser, so anything hidden, paywalled, or geo-blocked simply will not show up in the answer.
Some tasks you want done whether or not you are at the keyboard. Give a schedule a start URL, a goal, and a cadence — once, hourly, daily, or weekly — and Chrome alarms wake the agent on time, even with the side panel closed.
Task name: Morning release check
Start URL: https://github.com/KazKozDev/WebOperator/releases Repeat: daily Goal: Tell me if a new version was published since yesterday
Every run lands in History with its trace, so you can go back afterwards and see exactly what it did. If a run hits something only you can clear — a login wall, a verification challenge — it stops and marks itself needs_user rather than failing quietly.
Your live browser can be somebody else's tool. The local bridge speaks MCP over stdio and exposes ten of them: browser_snapshot, browser_navigate, browser_click, browser_type, browser_press, browser_scroll, browser_screenshot, browser_extract, browser_solve_captcha, and weboperator_execute_goal.
cd weboperator-bridge
./install.sh node mcp-server.js
install.sh registers the Native Messaging host that wires those calls to your active Chrome or Brave tab. Drop-in configs for Hermes and OpenClaw are already in weboperator-bridge/.
A goal arrives from the side panel or from an external MCP agent. From there the service worker runs the show — model calls, task state, retries, verification, schedules, storage. The content script does the hands-on part: it turns the page into an accessibility snapshot with stable element refs, then performs DOM actions against those refs. Whatever the page says is treated as data, never as instructions to follow. Twelve built-in skills sit on top as domain playbooks and kick in when the agent recognizes a matching site or task.
goal → page snapshot → model tool call → verified action → trace
Permissions
To read and act on the page you point it at, the extension asks for plus activeTab/tabs/scripting, and for debugger to reach the DevTools Protocol actions the plain DOM API cannot do. The rest are housekeeping: sidePanel for the UI, storage for settings and history, alarms for scheduled runs, downloads for the file-downloader skill, and nativeMessaging for the MCP bridge. bookmarks and tabGroups are optional and only requested when something actually needs them.
The debugger permission is why Chrome shows a yellow "WebOperator started debugging this browser" bar while an action runs. That bar belongs to Chrome, not to the extension, and it goes away as soon as the agent detaches.
Configuration and requirements
| Option | Default | What it does |
|---|---|---|
| Provider | ollama | Selects Ollama, Anthropic, DeepSeek, Gemini, MLX, OpenAI, an OpenAI-compatible endpoint of your own, OpenRouter, SiliconFlow, or xAI |
| Base URL (OpenAI-compatible) | http://127.0.0.1:8080/v1 | Points the OpenAI-compatible provider at llama.cpp, LM Studio, vLLM, LiteLLM, or any gateway |
| Ollama URL | http://127.0.0.1:11434 | Sets the local Ollama endpoint |
| Screenshot policy | auto | Controls automatic, always-on, or disabled vision |
| Action timeout | 10000 ms | Limits a single browser action attempt |
| Domain allowlist / blocklist | empty | Restricts or rejects tasks by domain when populated |
The bridge listens on 127.0.0.1:8765 and will accept unauthenticated calls until you set WEBOPERATOR_API_TOKEN. Set it. Every bridge variable — bind host, port, socket and log paths — is documented in docs/api.md.
shellcheck, only if you run the full local check gateLimitations
Troubleshooting
OLLAMA_ORIGINS="chrome-extension://phbohkmfojcjbmgfnaikenmgemgckdpg,http://localhost:*" ollama serve. The origin has to be spelled out: Ollama accepts chrome-extension://* into the list and then still answers 403. The id above is fixed by the manifest key, and the side panel's own error message repeats it.core/dist or at the unzipped release folder, not at the repository root.WEBOPERATOR_API_TOKEN on the bridge but the client is not sending it. Add Authorization: Bearer $WEBOPERATOR_API_TOKEN to the request.Bug reports, feature requests and pull requests are all welcome. CONTRIBUTING.md walks through the setup, the eight-step check gate every change has to clear, and the commit conventions. Released versions are listed in CHANGELOG.md.
Found a security problem? Please don't open a public issue — report it privately, the way SECURITY.md describes.
Manual installation, Docker, development setup
Each archive on the releases page ships with a .sha256 beside it, and is built and published by the release workflow from the tagged commit once the full check gate passes.
npm --prefix core ci && npm --prefix core run build, then load the result as an unpacked extension.
There is no Dockerfile or Compose configuration.
npm --prefix core run dev gives you watch builds. ./scripts/check.sh runs the whole gate: fixture evals, bridge smoke test, typecheck, lint, unit tests, dead-code scan, shellcheck, and build.
Issues · LICENSE · API · ARCHITECTURE · Agent protocol · LinkedIn