About Openchrome
Openchrome is an MCP server published by shaun0927 in the Browser category: open-source browser automation MCP server. Control your real Chrome from any AI agent.
The repository has 236 stars and 40 forks, with the last commit 19 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/shaun0927/openchromeThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Openchrome
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
OpenChrome
OpenChrome is a browser automation MCP server for controlling a real Chrome browser from Claude Code, Codex CLI, OpenCode, or any MCP client.
It ships as a Node CLI plus MCP runtime. Desktop apps, browser extensions, native-host installers, deployment templates, and release artifact builders are outside this repository surface.
Install
Requires Node.js 20 or newer.
npm install -g openchrome-mcp
openchrome setup --client codex
For Claude Code:
openchrome setup --client claude
Restart the MCP host after setup so it reloads the generated configuration.
Run
openchrome serve --auto-launch --auto-elect --minimal
Manual Codex CLI configuration:
openchrome config --client codex
Add the printed [mcp_servers.openchrome] block to ~/.codex/config.toml.
CLI
OpenChrome can call its MCP tools directly from the shell:
oc run navigate --arg url=https://example.com
oc run read_page --arg mode=dom --json
oc navigate https://example.com
oc click ref_5
Playbooks run deterministic YAML scenarios:
oc playbook run scenario.yaml --vars url=https://iana.org --out report.md
HTTP Mode
Run a long-lived MCP HTTP daemon when multiple clients should share one managed Chrome owner:
openchrome serve --http 3100 --auth-token <token> --idle-timeout 30m
curl -s http://127.0.0.1:3100/health
Independent stdio clients should use separate --port and --user-data-dir
profiles, or connect through broker mode with --auto-elect.
Both stdio and HTTP serve the stateless MCP 2026-07-28 revision alongside
legacy initialize-based clients; see docs/mcp-2026-07-28.md.
Capabilities
- Real Chrome control through CDP.
- Navigation, clicks, typing, screenshots, DOM reads, accessibility reads, and natural-language element lookup.
- Parallel tab/session workflows with broker-safe profile ownership.
- Compact page serialization for lower-token agent loops.
- Outcome contracts, evidence bundles, diffs, and diagnostics.
- Optional pilot-tier recovery and skill runtime behind
--pilot.
Full tool catalogue: docs/agent/capability-map.md.
Documentation
| Topic | Link |
|---|---|
| Architecture | docs/architecture.md |
| Getting started | docs/getting-started.md |
| CLI | docs/cli.md |
| Playbooks | docs/cli/playbook.md |
| MCP topologies | docs/mcp/topologies.md |
| MCP 2026-07-28 support | docs/mcp-2026-07-28.md |
| HTTP daemon | docs/getting-started/http-daemon.md |
| Security model | SECURITY.md |
| Repository structure | docs/dev/project-structure.md |
Development
git clone https://github.com/shaun0927/openchrome.git
cd openchrome
npm install
npm run build
npm test
Useful checks:
npm run lint
npm run lint:repo-structure
npm run lint:tier
npm run docs:capability-map:check
License
MIT
README fetched from the repository yesterday. The original is authoritative.