An MCP server to access Google News and Google Trends.
Project description
Google News Trends MCP
An MCP server to access Google News and Google Trends. Does not rely on any paid APIs.
Features
- Search Google News articles based on keyword, location, topic
- Get top news stories from Google News
- Google Trends keywords based on location
- Optional LLM Sampling and NLP to summarize articles and extract keywords
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file google_news_trends_mcp-0.2.0.tar.gz.
File metadata
- Download URL: google_news_trends_mcp-0.2.0.tar.gz
- Upload date:
- Size: 12.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.7.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7d2226355d56432e4049c17289a04ad6ed430806114f58d79be50cf908ea98bc
|
|
| MD5 |
eae5e438cac1230bd4e46074149089ae
|
|
| BLAKE2b-256 |
dbcc1d991257728492eaf20e32b920d24d289b9692d2401744aa352d6939d06b
|
File details
Details for the file google_news_trends_mcp-0.2.0-py3-none-any.whl.
File metadata
- Download URL: google_news_trends_mcp-0.2.0-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.7.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
79791cd8a543e460afbda2edd16b0ecebc20cd080b062149fe0abdba37b86d39
|
|
| MD5 |
8b3dcdb676630ae15050d3dae183d9cc
|
|
| BLAKE2b-256 |
7ea2211a14afdc1f480e970a8bd0fe93ff42820453e8deb3dcee178d58558f3b
|