Skip to main content
Glama

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: chrome-mcp-bridge

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

Guide

Description

Architecture Analysis

Critical issues and improvement roadmap

Architecture

System design and components

Troubleshooting

Complete troubleshooting and timeout resolution

Development Workflows

Code changes, testing, and development procedures

TypeScript

Type definitions and development

CLI Tools

Command-line interface and setup

Event Architecture

Visual system diagrams

Project Resources

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   │
                                        └──────────────┘ └──────────────┘

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.

      https://corapilot.com/mcp
    • Tidio MCP server for ChatGPT, Claude and any AI agent: list tickets, reply to ticket, update ticket, update contact properties, create macro and read conversation history in your own Tidio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Tidio yourself; Cotlet does not store your password and you need no Tidio API key. About the official Tidio API: Tidio has a REST API, the OpenAPI, for contacts, tickets, operators and departments, but only on the Plus and Premium plans, and its two official MCP servers cannot work your inbox (checked 17 Oct 2026). One MCP connector installs the chat widget; the other reads analytics and "can't send messages, change settings, or modify anything". Setup and FAQ: https://cotlet.dev/integrations/tidio-api-mcp-server

      https://cotlet.dev/mcp/v1/tidio
    • Chatwoot MCP server for ChatGPT, Claude and any AI agent: list conversations, reply to conversation, add private note, assign conversation, add labels and resolve or snooze conversation in your own Chatwoot account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Chatwoot yourself; Cotlet does not store your password and you need no Chatwoot API key. About the official Chatwoot API: Chatwoot has a full REST API, the Application API, and an official command-line client, but no official MCP server (checked 22 Oct 2026). The API covers conversations, messages, contacts, labels, teams and assignments with an access token from Profile Settings. Setup and FAQ: https://cotlet.dev/integrations/chatwoot-api-mcp-server

    • Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server

      https://cotlet.dev/mcp/v1/discord

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An ungated reimplementation of the 'Claude in Chrome' MCP bridge that exposes 22 browser-automation tools to any MCP client, driving the official Claude Chrome extension via native messaging without requiring a claude.ai login.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP bridge between Chromium browsers (Arc, Vivaldi, Brave) and Claude Code. 18 browser automation tools (navigate, click, forms, screenshots, GIF recording, console, network) plus a popup chat panel powered by the Claude Agent SDK.
      18
      10
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Chrome browser automation MCP server. Connect Claude (or any MCP client) to a real Chrome session — using your existing profiles with their cookies, saved passwords, and history.
      3
      -