Google Alerts Mcp

Name: Google Alerts Mcp
Author: ycrao

@ycrao

Repository Homepage

About Google Alerts Mcp

Google Alerts MCP Server

#google-alerts #news-retrieval #browser-simulation

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-alerts": {
      "command": "uvx",
      "args": [
        "google-alerts-mcp"
      ],
      "env": {}
    }
  }
}

Tools

Search Google Alerts for news articles about a specific topic by simulating the browser workflow

Overview

What is Google Alerts Mcp?

Google Alerts Mcp is an MCP (Model Context Protocol) server that fetches news articles from Google Alerts for a given topic. It simulates a browser workflow to dynamically extract state parameters and tokens, avoiding detection and blocking. It is intended for developers who want to programmatically retrieve Google Alerts content.

How to use Google Alerts Mcp?

Install dependencies with uv sync, then run the server or configure it as an MCP tool in your client. The server provides a search_google_alerts tool that accepts query (required), and optional language, region, and clean_urls parameters.

Key features of Google Alerts Mcp

Dynamic extraction of Google Alerts page state parameters and tokens
Anti‑detection using fresh cookies and session headers per request
Multi‑language search support (e.g., Chinese, English)
Automatic cleaning of Google redirect URLs to direct article links
No hard‑coded authentication values – all parameters are extracted dynamically

Use cases of Google Alerts Mcp

Monitor news articles about a specific topic (e.g., "bitcoin", "白银")
Integrate Google Alerts results into AI assistants or automated research pipelines
Retrieve clean, direct article links without Google redirect parameters
Search for news in different languages and regions from a single MCP tool

FAQ from Google Alerts Mcp

What does the `search_google_alerts` tool do?

It takes a query (topic) and returns a list of articles with title, URL, snippet, and source. You can also specify language (default zh‑CN), region (default US), and whether to clean Google redirect URLs.

What dependencies does Google Alerts Mcp require?

Python 3, uv package manager, and the packages mcp, httpx, beautifulsoup4, and pydantic.

How does anti‑detection work?

The server visits Google Alerts, extracts fresh window.STATE parameters (including a token) and session cookies, then uses them to build a preview URL. This prevents blocking by using dynamically obtained credentials for each request.

Can I get direct article links instead of Google redirect URLs?

Yes. By default clean_urls is true, which removes Google’s redirect wrapper and returns the target URL directly. Set clean_urls to false to keep the original redirect URL.