Real browser tabs. Wired to MCP.

A friendly localhost bridge from the official Codex Chrome Extension to GSD, Codex CLI, Claude Code, Cursor, Windsurf, and other MCP-compatible tools.

GitHub repo Official extension

MCP serverAI browser automationLocalhost bridgeAgent tools

Manual install

git clone https://github.com/bakhtiersizhaev/chromewire-mcp.git
cd chromewire-mcp
npm install
npm test
npm run doctor
npm run check
npm run smoke

Stdio: node src/stdio.js

HTTP endpoint: http://127.0.0.1:8962/mcp

🤖 Easy install via your AI agent

Copy one prompt into your coding agent. It should inspect the repo, follow skills/install-codex-chrome-mcp/SKILL.md, configure your MCP client, and verify the setup.

English

Look into this repository: https://github.com/bakhtiersizhaev/chromewire-mcp
Install ChromeWire MCP in my local AI CLI / agentic MCP setup. Add it as an MCP server for the CLI I am using. Follow the repository instructions and the agent install skill here: skills/install-codex-chrome-mcp/SKILL.md
Verify the required local prerequisites and the official Codex Chrome Extension: https://chromewebstore.google.com/detail/hehggadaopoacecdllhhajmbjkdcmajg
If the extension page is unavailable in my region, tell me that a USA IP via VPN/proxy may be required. Keep the MCP endpoint bound to 127.0.0.1. Run npm test, npm run check, npm run doctor, npm run smoke, then show me the final MCP config.

Русский

Посмотри этот репозиторий: https://github.com/bakhtiersizhaev/chromewire-mcp
Установи ChromeWire MCP в мой локальный AI CLI / agentic MCP setup. Добавь его как MCP server для CLI, которым я пользуюсь. Следуй инструкциям репозитория и agent install skill: skills/install-codex-chrome-mcp/SKILL.md
Проверь нужные локальные зависимости и официальный Codex Chrome Extension: https://chromewebstore.google.com/detail/hehggadaopoacecdllhhajmbjkdcmajg
Если страница расширения недоступна в моём регионе, скажи, что может понадобиться USA IP через VPN/proxy. MCP endpoint должен оставаться на 127.0.0.1. Запусти npm test, npm run check, npm run doctor, npm run smoke, потом покажи финальный MCP config.

中文

请查看这个仓库：https://github.com/bakhtiersizhaev/chromewire-mcp
请把 ChromeWire MCP 安装到我的本地 AI CLI / agentic MCP 环境中，并把它添加为当前 CLI 使用的 MCP server。请按照仓库说明和这个 agent install skill 执行：skills/install-codex-chrome-mcp/SKILL.md
请检查所需的本地依赖项和官方 Codex Chrome Extension：https://chromewebstore.google.com/detail/hehggadaopoacecdllhhajmbjkdcmajg
如果该扩展页面在我的地区无法打开，请告诉我可能需要使用 USA IP / VPN / proxy。MCP endpoint 必须保持绑定到 127.0.0.1。请运行 npm test、npm run check、npm run doctor、npm run smoke，然后给我最终 MCP config。

🧭 How it works

Chrome profile
  → Official Codex Chrome Extension
  → local native host / browser pipe
  → ChromeWire MCP bridge
  → MCP stdio or HTTP endpoint
  → AI CLI tools

🛡Safe by defaultBound to localhost. No cookies, history, passwords, or storage exposed by default.

🧭Real browserOpens, clicks, types, scrolls, screenshots, and reads visible text in actual browser tabs.

⚙️Agent-readyIncludes install/debug skills, MCP examples, CI, doctor checks, and smoke tests.

🏷 Category and tags

Developer tools · AI browser automation · MCP server · local-first automation.

✅ Requirements

Node.js 20+
Google Chrome
Official Codex Chrome Extension
Windows named pipes, macOS Unix sockets, or Linux/Ubuntu Unix sockets with the official Codex native host.

Region note: if the Chrome Web Store listing is unavailable in your region, a USA IP via VPN/proxy may be required to install the official extension. Use only legal, policy-compliant access methods.

🔌 MCP config

[mcp_servers.chromewire]
command = "node"
args = ["/absolute/path/to/chromewire-mcp/src/stdio.js"]
startup_timeout_sec = 20.0
tool_timeout_sec = 180.0

For Codex CLI on macOS, use /Applications/Codex.app/Contents/Resources/node as the command so Codex launches the MCP subprocess.

{
  "mcpServers": {
    "chromewire": {
      "type": "http",
      "url": "http://127.0.0.1:8962/mcp"
    }
  }
}