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

``bash
npm install -g @yuval1024/chrome-mcp


or use directly with npx


npx @yuval1024/chrome-mcp
`

Quick Start

$3

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

$3

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

Or add manually to your .claude.json:

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

$3

In your Claude Code conversation, connect to your browser:

`javascript
// 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

`bash
npx @yuval1024/chrome-mcp [options]

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

Troubleshooting

$3

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

$3

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