Chrome MCP

Control your Chrome browser from AI coding assistants using the Model Context Protocol (MCP).

Features

• 🌐 Control browser tabs remotely
• 📸 Take screenshots
• 🔍 Get tab information
• 🚀 Navigate tabs
• 🎯 Create and close tabs
• 🔒 Secure connection using browser UUID

Installation

npm install -g @yuval1024/chrome-mcp
# or use directly with npx
npx @yuval1024/chrome-mcp

Quick Start

1. Install Chrome Extension

1. Download the Chrome extension from releases
2. Load it in Chrome as an unpacked extension
3. Copy your Browser Secret (UUID) from the extension popup

2. Add to Claude Code

claude mcp add chrome-browser -- npx @yuval1024/chrome-mcp

Or add manually to your .claude.json:

{
  "mcpServers": {
    "chrome-browser": {
      "type": "stdio",
      "command": "npx",
      "args": ["@yuval1024/chrome-mcp"]
    }
  }
}

3. Connect in Claude Code

In your Claude Code conversation, connect to your browser:

// Use the connectToBrowser tool with your browser UUID
connectToBrowser("your-browser-uuid-here")

The UUID is displayed in the Chrome extension popup. Keep it secret!

Available Tools

Once connected, you can use these tools in Claude Code:

• connectToBrowser(browserSecret) - Connect to your browser
• getAllTabs() - Get information about all open tabs
• getCurrentUrl() - Get the URL of the active tab
• takeScreenshot({ tabId }) - Capture a screenshot
• navigateTab({ tabId, url }) - Navigate to a URL
• createTab({ url, windowId }) - Create a new tab
• closeTab({ tabId }) - Close a tab
• getConsoleLogs({ tabId }) - Get console logs
• getDOMSnapshot({ tabId }) - Get DOM structure

Security

• Your browser UUID acts as a password - keep it secret!
• Each browser instance has a unique UUID
• No additional authentication required
• Communication happens through a secure polling mechanism

Command Line Options

npx @yuval1024/chrome-mcp [options]

Options:
  -s, --server <url>  MCP server URL (default: https://api.browser-mcp.xyz)
  --debug             Enable debug logging
  --version           Show version
  --help              Show help

Troubleshooting

Browser not connecting?

1. Make sure the Chrome extension is installed and running
2. Check the extension popup shows "Connected" status
3. Verify the server URL matches in both extension and CLI

Claude Code can't connect?

1. Make sure you've added the MCP server to Claude Code
2. Run connectToBrowser("your-uuid") with the correct UUID
3. Check Claude Code logs for connection errors

License

MIT

Links

• GitHub Repository
• npm Package
• Chrome Extension