Google Search (via Chrome)

by cmann50

Recommended
21 stars
1.7k downloads
Not rated
GitHub

About

Integrates Google search and webpage content extraction via Chrome browser automation, enabling access up-to-date web information for tasks like fact-checking and research.

Details

Author
cmann50
Repository
cmann50/mcp-chrome-google-search
GitHub stars
21
Downloads
1,742
License
MIT License
Categories
Search
Tags
#google

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Google Search (via Chrome)
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @cmann50/mcp-chrome-google-search

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. 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

2. 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.

npx mcp-chrome-google-search

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

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google search (via chrome)": {
            "cwd": "",
            "env": {},
            "args": [
                "-y",
                "@cmann50/mcp-chrome-google-search"
            ],
            "shell": false,
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "cwd": "",
    "env": [],
    "args": [
        "-y",
        "@cmann50/mcp-chrome-google-search"
    ],
    "shell": false,
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

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

1. 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

2. 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

- Free to search google
- Opens and small windows and uses your chrome browser, so should not get blocked
- Since it is using your Chrome window it can access authenticated content. Claude can just open the URL in your browser.

Platform Support

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

Requirements

1. macOS 2. Google Chrome 3. Node.js 20 or higher

Alternative Installation Methods

NPX Installation

npx mcp-chrome-google-search

Custom Installation

1. Checkout from git 2. Run npm run build 3. Add to Claude config (use absolute path):
{
    "google-tools": {
        "command": "node",
        "args": [
            "/your/checkout/path/mcp/mcp-chrome-google-search/dist/index.js"
        ]
    }
}

Local development

To test changes locally bump package.json version and run
to put it in edit mode:

npm install -g .

Then just do npm run build and the files will go in dist where claude is monitoring

Then press ctrl-R in claude desktop, no need to restart it

Debugging

Log Monitoring

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

Dev Tools Access

1. Enable developer settings:
echo '{"allowDevTools": true}' > ~/Library/Application\ Support/Claude/developer_settings.json
2. Open DevTools: Command-Option-Shift-i in Claude desktop 3. 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)
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.