OpenChrome

v1.12.4Browser Automationstable

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

openchromemcpmcp-serverbrowser-automationparallel-sessions
Share:
206
Stars
0
Downloads
0
Weekly
0/5

What is OpenChrome?

OpenChrome is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to open-source browser automation mcp server. control your real chrome from any ai agent.

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

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Open-source browser automation MCP server. Control your real

Use Cases

Automate real Chrome browser from any AI agent.
Control parallel browser sessions concurrently.
Interact with web pages through Chrome DevTools Protocol.
shaun0927

Maintainer

LicenseMIT
Languagetypescript
Versionv1.12.4
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y openchrome-mcp

Manual Installation

npx -y openchrome-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenChrome

OpenChrome is an open-source MCP server that gives AI agents direct control of a real Chrome browser using the Chrome DevTools Protocol, supporting parallel browsing sessions, form automation, DOM reading, performance profiling, and site monitoring. Unlike headless browser tools, it operates on your actual installed Chrome instance, preserving existing logins, cookies, and extensions so agents can access authenticated dashboards and member-only content immediately. With 118 available tools organized into navigation, reading, extraction, diagnostics, and async crawling categories, it is suitable for web scraping, UI testing, production debugging, and multi-step form automation.

Prerequisites

  • Node.js 18+ installed
  • Google Chrome installed on your machine (not Chromium — the real Chrome binary)
  • Claude Desktop, Claude Code, or another MCP-compatible AI client
  • npm access to install the openchrome-mcp package globally
1

Install the openchrome-mcp package globally

Install the OpenChrome MCP server binary globally via npm so the openchrome command is available on your PATH.

npm install -g openchrome-mcp
2

Run the setup command for your MCP client

Run the appropriate setup command for your AI client. This automatically registers the server in the client's MCP configuration.

# For Claude Desktop / Claude Code
openchrome setup

# For Codex CLI
openchrome setup --client codex

# For OpenCode
npx openchrome-mcp setup --client opencode
3

Verify Chrome is detected

Run the doctor command to confirm OpenChrome can locate your Chrome installation, has disk access, and that the CDP port is available.

openchrome doctor
4

Configure manually for Cursor, VS Code, or Windsurf

For clients that do not have an automated setup command, add the following JSON block to your MCP client's config file manually.

5

Use Claude to automate Chrome

Ask Claude to navigate to a URL, read page content, fill a form, or capture performance metrics. Chrome will launch automatically on the first tool invocation when using --auto-launch.

OpenChrome Examples

Client configuration

Manual MCP config for Cursor, VS Code, Windsurf, or any client not covered by the openchrome setup command. The --auto-launch flag starts Chrome on first use.

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

Prompts to try

Use these prompts in Claude Desktop or Claude Code to drive Chrome through OpenChrome.

- "Compare AirPods Pro prices across Amazon, eBay, Walmart, and Best Buy simultaneously"
- "Navigate to my company dashboard at https://app.example.com and take a screenshot of the metrics page"
- "Fill out and submit the contact form at https://example.com/contact with these details: ..."
- "Capture Core Web Vitals (LCP, CLS) for https://example.com and report the results"
- "Crawl https://docs.example.com and extract all page titles and URLs"

Troubleshooting OpenChrome

openchrome doctor reports Chrome binary not found

OpenChrome looks for the standard Chrome installation path. On macOS it expects Chrome at /Applications/Google Chrome.app. If Chrome is installed elsewhere, ensure the 'google-chrome' or 'google-chrome-stable' binary is on your PATH, or reinstall Chrome to the default location.

CDP port conflict: address already in use

Another Chrome instance is using the CDP port. Close all Chrome windows and any other tools using remote debugging, then restart OpenChrome. You can also check with 'lsof -i :9222' (macOS/Linux) to identify the conflicting process.

After updating openchrome-mcp, old tools or behaviors persist

Run 'npm install -g openchrome-mcp@latest' to update, then re-run 'openchrome setup' for your client to refresh the registration. The update command alone does not migrate existing host registrations.

Frequently Asked Questions about OpenChrome

What is OpenChrome?

OpenChrome is a Model Context Protocol (MCP) server that open-source browser automation mcp server. control your real chrome from any ai agent. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenChrome?

Install via npm with the command: npx -y openchrome-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with OpenChrome?

OpenChrome works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenChrome free to use?

Yes, OpenChrome is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openchrome": { "command": "npx", "args": ["-y", "openchrome-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenChrome?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides