Google Search

You can run an MCP server that provides Google search capabilities and webpage content extraction, with built‑in OAuth login, hosted on Cloudflare Workers. This server lets you search the web, pull and convert webpage content into readable text, and connect tools to an external assistant or workflow for automated insights.

How to use

You will interact with the Google Search MCP Server through an MCP client. Start the server locally in development or deploy it to a hosting environment, then connect your MCP client (like Claude Desktop or an MCP Inspector) to the server to access the available tools.

How to install

Prerequisites: you need Node.js and npm installed on your machine. Ensure you have a modern runtime with npm available.

# Clone the project repository
git clone https://github.com/your-username/google-search-engine-mcp-server.git

# Install dependencies
cd google-search-engine-mcp-server
npm install

# Run locally for development
npm run dev

# Visit the server status in your browser
# http://localhost:8787/

Configuration and security

This server uses OAuth for authentication and exposes a set of tools to perform Google searches and content extraction. To deploy to a remote environment, you will typically configure environment variables for API keys and endpoints, then deploy the server and connect your MCP clients to the deployed URL.

{
  "mcpServers": {
    "google_search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Troubleshooting

If you run into issues, try these steps in order: restart your client, test the MCP connection directly from the command line, clear local MCP authentication data, and check logs for detailed errors.

# Restart your client or application
# Example: restart Claude Desktop or MCP Inspector

# Test direct connection to the local MCP server
npx mcp-remote http://localhost:8787/sse

# Clear stored MCP authentication data if needed
rm -rf ~/.mcp-auth

Developer notes

This project is built with TypeScript and runs on Cloudflare Workers with Durable Objects. It integrates OAuth authentication and uses Google Custom Search API for search results. It also includes tools for webpage content extraction and batch processing.

Available tools

google_search

Performs Google searches and returns results.

extract_webpage_content

Extracts content from webpages and converts it to readable text.

batch_extract_webpage_content

Batch processes multiple webpages to extract and summarize content.