OpenCode Browser plugin
An OpenCode plugin that wires in Browser MCP so the agent drives Chrome or Edge, fills forms, clicks and tests sites.
- 115 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent works in your real browser and sees open tabs and saved logins.
Install
- Works in
Manual install
npx opencode-browser initThe fastest route in the README: the command writes the plugin and mcp.browsermcp entries into opencode.json.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent works in your real browser and sees open tabs and saved logins.
This is third-party code. Review the repository files before installing.
What it does
OpenCode Browser MCP Plugin connects the Browser MCP service to OpenCode and gives the model browser control: navigating sites, clicking, filling forms and other actions. The plugin works with OpenCode 1 version 1.18.29 and newer and with OpenCode 2 from one package. On top of the connection it injects prompt guidance for fast browser work and separate hints for expensive actions. Browser-related tasks are detected automatically, and page state is preserved across session compaction. Retries run with no artificial delay. The npx opencode-browser init command creates or updates opencode.json with the needed plugin and mcp.browsermcp entries and keeps other settings intact. The MCP package version is pinned.
Who it is for. OpenCode users who need a browser agent for testing web interfaces, filling forms and collecting data from open pages.
Good fit when
- A registration form must be run on a test stand to see what the page returns.
- An agent should collect data from a site open in your browser.
- Browser MCP must be set up for all projects through the global `opencode.json` file.
- A session with browser steps is compacted but page state must not be lost.
Not a fit when
- You do not use OpenCode: the plugin is built for it.
- The Browser MCP extension cannot be installed in the browser.
- You need headless operation without your browser: the server drives an open Chrome or Edge.
Example request
Open the login page on the test stand, fill the form with test data and tell me which error the server returned.Limitations
Node.js, OpenCode 1.18.29 or newer or OpenCode 2 and the Browser MCP extension for Chrome or Edge are required. The plugin does not control the browser itself: control goes through an MCP server launched with npx. The agent acts in your real browser, so open tabs and saved logins are reachable. For OpenCode 2 the configuration can be moved to the plugins and mcp.servers shape. A plugin version below 1.3.0 raises a plugin definition error, and updating fixes it.
How to disable. Remove opencode-browser from the plugin array and the browsermcp entry from the mcp block in opencode.json, then uninstall the Browser MCP extension from the browser.
FAQ
How do I connect the plugin?
Install the Browser MCP extension, then run `npx opencode-browser init`, which creates or updates `opencode.json`. Add `--global` for a global setup.
How do I preview the config without writing it?
Run `npx opencode-browser init --print`: it prints the config and writes nothing.
Where is the config file?
Globally in `~/.config/opencode/opencode.json`, and per project in `./opencode.json` at the root.
Does the plugin work with OpenCode 2?
Yes, one package supports OpenCode 1 and 2. For 2 you can switch to the `plugins` and `mcp.servers` shape.
Which Browser MCP version does the plugin use?
The generated command pins the `@browsermcp/mcp@0.1.3` package so launches are reproducible.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code plugin with an MCP server and seven skills: the agent drives a real browser by writing Python code
A plugin and MCP server letting an agent drive your open, already logged-in Chrome through an extension with no debugging port.
A CLI, Chrome extension, SDKs and MCP server that let an agent drive your real Chrome, whatever the agent runtime
An MCP server that drives your already open Chrome and stops to ask you about a 2FA code, a CAPTCHA, or a choice only you can make
A Chrome extension with an MCP server: the agent drives your everyday browser with its sessions, tabs, bookmarks and history
An MCP bridge to control your browser from a coding agent: a Chrome extension and a set of tab and page automation tools
README in short
The repository contains a TypeScript plugin, an init command, configuration examples and a demo video. It includes a quickstart, an examples file and an architecture description. Connecting to OpenCode needs no file copying: the plugin is downloaded from npm.