# OpenChrome

Unvalidated

npm [Github](https://github.com/shaun0927/openchrome)

2.0.0

[shaun0927](https://github.com/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.

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

|  | Traditional | OpenChrome |
| --- | --- | --- |
| **5-site task** | ~250s (login each) | **~3s** (parallel) |
| **Memory** | ~2.5 GB (5 browsers) | **~300 MB** (1 Chrome) |
| **Auth** | Every time | **Never** |
| **Bot detection** | Flagged | **Invisible** |

---

## Quick Start

```
npx openchrome setup
```

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

**Claude Code:**

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

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

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

**Cursor / Windsurf / Other MCP clients:**

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

---

## How It Works

```plaintext
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:**

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

**Multi-account:**

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

**Competitive intelligence:**

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

---

## 47 Tools

| Category | Tools |
| --- | --- |
| **Navigate & Interact** | `navigate`, `click_element`, `fill_form`, `wait_and_click`, `find`, `computer` |
| **Read & Extract** | `read_page`, `page_content`, `javascript_tool`, `selector_query`, `xpath_query` |
| **Environment** | `emulate_device`, `geolocation`, `user_agent`, `network` |
| **Storage & Debug** | `cookies`, `storage`, `console_capture`, `performance_metrics`, `request_intercept` |
| **Parallel Workflows** | `workflow_init`, `workflow_collect`, `worker_create`, `batch_execute` |
| **Memory** | `memory_record`, `memory_query`, `memory_validate` |

`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

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

---

## Cross-Platform

| Platform | Status |
| --- | --- |
| **macOS** | Full support |
| **Windows** | Full support (taskkill process cleanup) |
| **Linux** | Full support (Snap paths, `CHROME_PATH` env, `--no-sandbox` for CI) |

---

## Development

```bash
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

```plaintext
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)