Claude Chrome MCP

Browser automation tool enabling MCP clients (Claude Desktop, Claude Code, Cursor) to interact with claude.ai through Chrome extension and MCP server.

Components

• MCP Server

• Chrome Extension (enabled only for claude.ai)

• CLI Tool

Related MCP server: Chromanche

Quick Start

Prerequisites

• Google Chrome browser

• Node.js v16 or higher

• npm installed

Step 1: Install Chrome Extension

1. Open Chrome and navigate to chrome://extensions/

2. Enable "Developer mode" (toggle in top right)

3. Click "Load unpacked" and select the extension/ directory from this project

4. The extension icon should appear in your toolbar

Step 2: Install Dependencies

# From the project root directory
cd mcp-server
npm install

Step 3: Configure Claude Desktop

1. Open Claude Desktop settings

2. Navigate to Developer > Edit Config

3. Add this configuration:

{
  "mcpServers": {
    "claude-chrome-mcp": {
      "command": "node",
      "args": ["<absolute-path-to-project>/mcp-server/src/server.js"]
    }
  }
}

Replace <absolute-path-to-project> with the full path to this project (e.g., /Users/yourname/claude-chrome-mcp)

Step 4: Restart Claude Desktop

After adding the configuration, restart Claude Desktop to load the MCP server. The server will automatically start its embedded WebSocket relay on port 54321.

Step 5: Test the Connection

In Claude Desktop, you can now use natural language commands like:

• "Check Chrome status"

• "Open a new tab"

• "Send 'Hello, World!' to the new Claude tab"

• "List all open Claude tabs"

• "Search for Claude chats with 'math'"

Key Features

• Async message sending with completion detection

• Claude-to-Claude response forwarding

• Conversation management via Claude.ai API

• Network inspection and debugging tools

• WebSocket-only architecture with persistent connections

• Health monitoring endpoint for relay status

Documentation

Project Resources

• MCP Configuration - Quick commands and setup

• GitHub Releases - Release history

• GitHub Issue Script - Claude Code integration utilities

CLI Tool (Optional)

npm install && npm run build && npm link

Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Claude.ai     │    │ Chrome Extension │    │ WebSocket Relay │
│   (Browser)     │◄──►┤ (Offscreen Doc)  │◄──►│   Port 54321    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                                         ▲
                                                         │
                                                ┌────────┴────────┐
                                                │                 │
                                        ┌───────▼──────┐ ┌───────▼──────┐
                                        │ MCP Server   │ │ Claude Code  │
                                        │ (Relay Mode) │ │ MCP Client   │
                                        └──────────────┘ └──────────────┘