OpenChrome

Unvalidated

npm Github

2.0.0

shaun0927
Mar 07, 2026

TypeScript
MIT License

Overview

What can you do with this MCP Server?

Open-source browser automation MCP server that connects to your real Chrome browser. No credentials or 2FA required. Uses your actual logged-in Chrome instance for fast, parallel browser automation.

What is OpenChrome?

An MCP server that connects to your actual Chrome — already logged in to everything. No credentials. No blank browsers. No 2FA loops.

You: oc screenshot my AWS billing and Stripe dashboard
AI:  [2 parallel workers, 2.1s — both done. Already logged in.]

Quick Start

npx openchrome setup

That's it. Say oc to your AI agent.

Claude Code:

claude mcp add openchrome -- npx -y openchrome serve --auto-launch

VS Code / Copilot (.vscode/mcp.json):

{
  "servers": {
    "openchrome": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "openchrome", "serve", "--auto-launch"]
    }
  }
}

Cursor / Windsurf / Other MCP clients:

{
  "mcpServers": {
    "openchrome": {
      "command": "npx",
      "args": ["-y", "openchrome", "serve", "--auto-launch"]
    }
  }
}

How It Works

Traditional:  [blank browser] → login → 2FA → wait → task → close  (per site)
OpenChrome:   [your Chrome]   → task                                 (done)

OpenChrome connects to your running Chrome via CDP. You're already logged in. Workers run in parallel with isolated contexts (separate cookies, sessions). One Chrome process, 20+ simultaneous sessions, ~300MB total.

Examples

Parallel monitoring:

oc screenshot AWS billing, GCP console, Stripe, and Datadog — all at once
→ 4 workers, 3.1s, already authenticated everywhere

Multi-account:

oc check orders on personal and business Amazon accounts simultaneously
→ 2 workers, isolated sessions, same site different accounts

Competitive intelligence:

oc compare prices for "AirPods Pro" across Amazon, eBay, Walmart, Best Buy
→ 4 workers, 4 sites, 2.4s, works past bot detection

47 Tools

navigate computer read_page find click_element wait_and_click form_input fill_form javascript_tool page_reload page_content page_pdf wait_for user_agent geolocation emulate_device network selector_query xpath_query cookies storage console_capture performance_metrics request_intercept drag_drop file_upload http_auth worker_create worker_list worker_update worker_complete worker_delete tabs_create_mcp tabs_context_mcp tabs_close workflow_init workflow_status workflow_collect workflow_collect_partial workflow_cleanup execute_plan batch_execute lightweight_scroll memory_record memory_query memory_validate oc_stop

CLI

oc setup                    # Auto-configure
oc serve --auto-launch      # Start server
oc serve --headless-shell   # Headless mode
oc doctor                   # Diagnose issues

Cross-Platform

Development

git clone https://github.com/shaun0927/openchrome.git
cd openchrome
npm install && npm run build && npm test

License

MIT

Installation Configuration

I'm an Agent

Send this prompt to your agent to install the MCP server

Read https://lobehub.com/mcp/shaun0927-openchrome/skill.md and follow the instructions to setup LobeHub MCP Marketplace and install the MCP server.

Table of Contents

• [What is OpenChrome?](/content/mcp/shaun0927-openchrome#what-is-open-chrome "What is OpenChrome?"/index.html)
• [Quick Start](/content/mcp/shaun0927-openchrome#quick-start "Quick Start"/index.html)
• [How It Works](/content/mcp/shaun0927-openchrome#how-it-works "How It Works"/index.html)
• [Examples](/content/mcp/shaun0927-openchrome#examples "Examples"/index.html)
• [47 Tools](/content/mcp/shaun0927-openchrome#47-tools "47 Tools"/index.html)
• [CLI](/content/mcp/shaun0927-openchrome#cli "CLI"/index.html)
• [Cross-Platform](/content/mcp/shaun0927-openchrome#cross-platform "Cross-Platform"/index.html)
• [Development](/content/mcp/shaun0927-openchrome#development "Development"/index.html)
• [License](/content/mcp/shaun0927-openchrome#license "License"/index.html)