google-news-mcp

diaorui/google-news-mcp

3.2

If you are the rightful owner of google-news-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Google News MCP Server provides a structured way to access and filter Google News articles with advanced search capabilities and automatic URL resolution.

Tools
3
Resources
0
Prompts
0

Google News MCP Server

MCP server for accessing Google News with filtering, topics, and automatic URL resolution.

Installation

git clone <repository-url> google-news-mcp
cd google-news-mcp
npm install
npm run build

Setup

With Claude Code

claude mcp add --transport stdio google-news node /path/to/google-news-mcp/dist/index.js

With Gemini CLI

gemini mcp add --transport stdio google-news node /path/to/google-news-mcp/dist/index.js

Testing Locally

npx @modelcontextprotocol/inspector node dist/index.js

Tools

search_google_news

Search with filters. URLs are automatically resolved to actual article URLs.

Parameters:

  • query (required): Search terms. Supports OR, "exact phrases", -exclusion
  • when: Time range - 1h, 12h, 1d, 7d, etc.
  • after/before: Date range (YYYY-MM-DD)
  • site: Filter by domain (e.g., reuters.com)
  • location: Filter by location (e.g., New York)
  • inTitle: Search only in titles (default: false)
  • language: Language code (default: en)
  • region: Country code (default: US)
  • limit: Max results (default: 20, max: 100)

Examples:

// Recent news from specific source
search_google_news({
  query: "bitcoin",
  site: "reuters.com",
  when: "24h"
})

// Location-specific with date range
search_google_news({
  query: "SpaceX launch",
  location: "Florida",
  after: "2025-12-01",
  before: "2025-12-03"
})

// Title-only precise search
search_google_news({
  query: "\"Federal Reserve\" rate decision",
  inTitle: true,
  when: "6h"
})

get_topic_news

Get news from predefined topics.

Parameters:

  • topicName (required): BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH, WORLD, US
  • language, region, limit: Same as search

Example:

get_topic_news({ topicName: "TECHNOLOGY", limit: 10 })

get_top_headlines

Get current top headlines.

Parameters:

  • language, region, limit: Same as search

Example:

get_top_headlines({ region: "GB", language: "en" })

Response Format

{
  headline: string;   // Article headline
  source: string;     // News source name
  url: string;        // Direct article URL (auto-resolved)
  pubDate: string;    // UTC timestamp (YYYY-MM-DD HH:MM:SS UTC)
}

Note: This returns headlines and metadata only. Use a web fetching tool to read full article content.

Development

npm run build      # Build
npm run watch      # Watch mode
npm run dev        # Run directly
npm run clean      # Clean artifacts

License

MIT