MCP Chrome Google Search Tool

MCP tool for Google search and webpage content extraction using Chrome browser. Works with Claude to enable Google search and content fetching capabilities.

Quick Installation

Configure Claude Desktop
- Open Claude Desktop on Mac
- Go to Claude > Settings > Developer > Edit Config
- Add the following to your config file:
{ "mcpServers": { "mcp-chrome-google-search": { "command": "npx", "args": [ "-y", "@cmann50/mcp-chrome-google-search" ] } } }
- Restart Claude Desktop
First Time Setup
- Grant Accessibility Permissions
  - On first run, approve macOS accessibility permissions prompt
  - Navigate to: System Preferences > Security & Privacy > Privacy > Accessibility
  - Add and enable permissions for your terminal app
- Enable Chrome JavaScript from Apple Events
  - Open Chrome
  - Navigate to: View > Developer > Allow JavaScript from Apple Events
  - One-time setup only

Once configured, Claude will be able to perform Google searches and extract webpage content through Chrome when you make requests.

Key Advantages

Runs Chrome browser via osascript/applescript, avoiding typical blocking issues
Can access authenticated content - Claude can read internal wikis and other logged-in content
Secure implementation - limited to specific Chrome operations (see mcp-chrome-google-search/src/browser/chrome.ts):
- Page text extraction using document.body.innerText
- Google search via https://www.google.com/search?q=${encodedQuery}&hl=en

Platform Support

✅ macOS
❌ Windows (not supported)
❌ Linux (not supported)

Requirements

macOS
Google Chrome
Node.js 16 or higher

Alternative Installation Methods

NPX Installation

npx mcp-chrome-google-search

Custom Installation

Checkout from git
Run npm run build
Add to Claude config (use absolute path):

{
    "google-tools": {
        "command": "node",
        "args": [
            "/your/checkout/path/mcp/mcp-chrome-google-search/dist/index.js"
        ]
    }
}

Debugging

Log Monitoring

# Follow logs in real-time
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

Dev Tools Access

Enable developer settings:

echo '{"allowDevTools": true}' > ~/Library/Application\ Support/Claude/developer_settings.json

Open DevTools: Command-Option-Shift-i in Claude desktop
Use ctrl-r in Claude desktop while tailing for better errors

Troubleshooting

Chrome JavaScript Error

If you see:

execution error: Google Chrome got an error: Executing JavaScript through AppleScript 
is turned off. For more information: https://support.google.com/chrome/?p=applescript (12)

Solution:

Open Chrome
View > Developer > Allow JavaScript from Apple Events

Accessibility Permission Issues

If Chrome control fails:

Open System Preferences
Security & Privacy > Privacy > Accessibility
Ensure terminal app is listed and enabled
Use lock icon to make changes if needed

Implementation Details

Uses AppleScript for Chrome control
Visible automation - Chrome windows will open/navigate
Each request opens a new Chrome tab
Close unused tabs periodically for optimal performance
Only use with trusted Claude instances (has Chrome control access)

Support

Create GitHub issues for problems
Include macOS and Chrome version details

License

MIT License - see LICENSE file for details