Chrome Profile MCP Server

MCP server that launches Chrome with a specific user profile and exposes browser control tools via the Model Context Protocol. AI agents (Claude Code, Claude Desktop, etc.) can then navigate, click, type, take screenshots, and more — all using your real Chrome sessions, cookies, and extensions.

Quick Start

# Interactive mode — pick a profile
npx chrome-profile-mcp

# Non-interactive — specify profile directly
npx chrome-profile-mcp --profile "Default"

CLI Flags

Claude Code Integration

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "chrome": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "chrome-profile-mcp", "--profile", "Default"]
    }
  }
}

Or with a local build:

{
  "mcpServers": {
    "chrome": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/chrome-profile-mcp/dist/cli.js", "--profile", "Default"]
    }
  }
}

Claude Desktop Integration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "chrome-browser": {
      "command": "node",
      "args": ["/path/to/chrome-profile-mcp/dist/cli.js", "--profile", "Default"]
    }
  }
}

Note: --profile is required for Claude Code/Desktop since there's no TTY for interactive selection.

Available Tools (18)

Navigation (8)

Interaction (6)

Inspection (4)

How It Works

1. Reads Chrome's Local State to discover available profiles

2. Launches Chrome with --remote-debugging-port using the selected profile

3. Connects via Chrome DevTools Protocol (CDP) using Playwright

4. Starts an MCP server on stdio that exposes 20 browser control tools

5. AI agents call tools to control your real Chrome browser

Requirements

• macOS (Chrome path hardcoded to /Applications/Google Chrome.app)

• Google Chrome installed (launched at least once)

• Node.js 18+

Known Limitations

• macOS only (Linux/Windows paths not yet supported)

• Chrome must not already be running with --remote-debugging-port on the same port

• CDP has lower fidelity than Playwright's native protocol for some operations

• get_page_content truncates at 50K chars to prevent context overflow

Development

npm install
npm run build
npm run dev          # Run with tsx (interactive mode)
npm run dev -- --profile Default  # Non-interactive

License

MIT