README - google-news-trends-mcp by jmanek

Google News Trends MCP

An MCP server that slurps data from Google News and Google Trends RSS endpoints, optionally distills it with LLM/NLP, and barfs out structured results.

Features

Trawl Google News RSS feeds for articles based on keyword, location, topic
Ingest top news stories from Google News
Snag trending search terms from Google Trends based on geographic input
Plug in LLM/NLP pipelines to condense article payloads and extract key concepts

Installation

Using uv/uvx (recommended)

When using uv no specific installation is needed. We will use uvx to directly run google-news-trends-mcp.

Using PIP

pip install google-news-trends-mcp

After installation, you can run it as a script using:

python -m google_news_trends_mcp

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

{
  "mcpServers": {
    "google-news-trends": {
      "command": "uvx",
      "args": ["google-news-trends-mcp@latest"]
    }
  }
}

Using pip installation

{
  "mcpServers": {
    "google-news-trends": {
      "command": "python",
      "args": ["-m", "google_news_trends_mcp"]
    }
  }
}

Configure for VS Code

Using uvx

{
  "mcp": {
    "servers": {
      "google-news-trends": {
        "command": "uvx",
        "args": ["google-news-trends-mcp@latest"]
      }
    }
  }
}

Using pip installation

{
  "mcp": {
    "servers": {
      "google-news-trends": {
        "command": "python",
        "args": ["-m", "google_news_trends_mcp"]
      }
    }
  }
}

Tools

The following MCP tools are available:

Tool Name	Description
get_news_by_keyword	Search for news using specific keywords.
get_news_by_location	Retrieve news relevant to a particular location.
get_news_by_topic	Get news based on a chosen topic.
get_top_news	Fetch the top news stories from Google News.
get_trending_keywords	Return trending keywords from Google Trends for a specified location.

All of the news related tools have an option to summarize the text of the article using LLM Sampling (if supported) or NLP

CLI

All tools can be accessed from the command line using uv

uv run google-news-trends
Usage: google-news-trends [OPTIONS] COMMAND [ARGS]...

  Find and download news articles using Google News.

Options:
  --help  Show this message and exit.

Commands:
  keyword   Find articles by keyword using Google News.
  location  Find articles by location using Google News.
  top       Get top news stories from Google News.
  topic     Find articles by topic using Google News.
  trending  Returns google trends for a specific geo location.

Debugging

npx @modelcontextprotocol/inspector uvx google-news-trends-mcp

To run from within locally installed project

cd path/to/google/news/tends/mcp
npx @modelcontextprotocol/inspector uv run google-news-trends-mcp

Testing

cd path/to/google/news/tends/mcp
python -m pytest