Skip to content
Back to search

openchrome

Open-source browser automation MCP server. Control your real Chrome from any AI agent.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shaun0927--openchrome/badge.svg)](/listings/shaun0927--openchrome)

HTML

<a href="/listings/shaun0927--openchrome"><img src="/api/listings/shaun0927--openchrome/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 121 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # OpenChrome
  2. OpenChrome is a browser automation MCP server for controlling a real Chrome
  3. browser from Claude Code, Codex CLI, OpenCode, or any MCP client.
  4. It ships as a Node CLI plus MCP runtime. Desktop apps, browser extensions,
  5. native-host installers, deployment templates, and release artifact builders are
  6. outside this repository surface.
  7. ## Install
  8. Requires Node.js 20 or newer.
  9. ```bash
  10. npm install -g openchrome-mcp
  11. openchrome setup --client codex
  12. ```
  13. For Claude Code:
  14. ```bash
  15. openchrome setup --client claude
  16. ```
  17. Restart the MCP host after setup so it reloads the generated configuration.
  18. ## Run
  19. ```bash
  20. openchrome serve --auto-launch --auto-elect --minimal
  21. ```
  22. Manual Codex CLI configuration:
  23. ```bash
  24. openchrome config --client codex
  25. ```
  26. Add the printed `[mcp_servers.openchrome]` block to `~/.codex/config.toml`.
  27. ## CLI
  28. OpenChrome can call its MCP tools directly from the shell:
  29. ```bash
  30. oc run navigate --arg url=https://example.com
  31. oc run read_page --arg mode=dom --json
  32. oc navigate https://example.com
  33. oc click ref_5
  34. ```
  35. Playbooks run deterministic YAML scenarios:
  36. ```bash
  37. oc playbook run scenario.yaml --vars url=https://iana.org --out report.md
  38. ```
  39. ## HTTP Mode
  40. Run a long-lived MCP HTTP daemon when multiple clients should share one managed
  41. Chrome owner:
  42. ```bash
  43. openchrome serve --http 3100 --auth-token <token> --idle-timeout 30m
  44. curl -s http://127.0.0.1:3100/health
  45. ```
  46. Independent stdio clients should use separate `--port` and `--user-data-dir`
  47. profiles, or connect through broker mode with `--auto-elect`.
  48. Both stdio and HTTP serve the stateless MCP `2026-07-28` revision alongside
  49. legacy `initialize`-based clients; see [`docs/mcp-2026-07-28.md`](docs/mcp-2026-07-28.md).
  50. ## Capabilities
  51. - Real Chrome control through CDP.
  52. - Navigation, clicks, typing, screenshots, DOM reads, accessibility reads, and
  53. natural-language element lookup.
  54. - Parallel tab/session workflows with broker-safe profile ownership.
  55. - Compact page serialization for lower-token agent loops.
  56. - Outcome contracts, evidence bundles, diffs, and diagnostics.
  57. - Optional pilot-tier recovery and skill runtime behind `--pilot`.
  58. Full tool catalogue: [`docs/agent/capability-map.md`](docs/agent/capability-map.md).
  59. ## Documentation
  60. | Topic | Link |
  61. | --- | --- |
  62. | Architecture | [`docs/architecture.md`](docs/architecture.md) |
  63. | Getting started | [`docs/getting-started.md`](docs/getting-started.md) |
  64. | CLI | [`docs/cli.md`](docs/cli.md) |
  65. | Playbooks | [`docs/cli/playbook.md`](docs/cli/playbook.md) |
  66. | MCP topologies | [`docs/mcp/topologies.md`](docs/mcp/topologies.md) |
  67. | MCP 2026-07-28 support | [`docs/mcp-2026-07-28.md`](docs/mcp-2026-07-28.md) |
  68. | HTTP daemon | [`docs/getting-started/http-daemon.md`](docs/getting-started/http-daemon.md) |
  69. | Security model | [`SECURITY.md`](SECURITY.md) |
  70. | Repository structure | [`docs/dev/project-structure.md`](docs/dev/project-structure.md) |
  71. ## Development
  72. ```bash
  73. git clone https://github.com/shaun0927/openchrome.git
  74. cd openchrome
  75. npm install
  76. npm run build
  77. npm test
  78. ```
  79. Useful checks:
  80. ```bash
  81. npm run lint
  82. npm run lint:repo-structure
  83. npm run lint:tier
  84. npm run docs:capability-map:check
  85. ```
  86. ## License
  87. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.