Google News MCP Server

npmGitHub
JavaScript
MIT License
70
2
RedditDiscord
A
security – no known vulnerabilities (report Issue)
A
license - permissive license (MIT License)
A
quality - confirmed to work

This server enables users to perform Google News searches with automatic categorization and multi-language support via SerpAPI integration.

Need Help?View Source CodeReport Issue
  1. Schema
  2. Server Configuration
  3. README.md
  4. Reviews

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
google_news_searchSearch Google News for articles and news content. Results will be automatically categorized by topic.

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SERP_API_KEYYesYour SERP API key required for accessing Google News search capabilities via SerpAPI.
README.md
<div align="center"> <h1><img src="public/server-google-news.svg" width="80px"><br/>Google News MCP Server</h1> <img src="https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white"/> <img src="https://img.shields.io/badge/Node.js-43853D?style=flat&logo=node.js&logoColor=white"/> <img src="https://img.shields.io/badge/MCP-Server-blue?style=flat"/> <img src="https://img.shields.io/badge/License-MIT-brightgreen?style=flat"/> </div> <br/>

<br/>

A Model Context Protocol (MCP) server implementation that provides Google News search capabilities via SerpAPI integration. Automatically categorizes news results and supports multiple languages and regions.

<a href="https://glama.ai/mcp/servers/dbx6imq4ef"><img width="380" height="200" src="https://glama.ai/mcp/servers/dbx6imq4ef/badge" alt="Google News Server MCP server" /></a>

https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

✨ Features

🔍 Flexible Search Options

Comprehensive search capabilities including query-based search, topic search, publication filtering and story coverage.

🌐 Global Coverage

Supports multiple languages and regions through configurable language and country codes.

📊 Smart Categorization

Automatically categorizes news results into topics like AI & Technology, Business, Science & Research, and Healthcare.

🔀 Multiple Result Types

Handles various news result types including headlines, stories, related topics and menu links.

🛠️ Robust Error Handling

Comprehensive error handling for API failures and invalid inputs, with helpful error messages.

🌍 Language Support

Automatic fallback to English for unsupported language codes with appropriate user notifications.

🔑 SERP API Setup Guide

Before getting started, you'll need to obtain a SERP API key. Here's how:

  1. Visit SERP API website and create an account
  2. After registration, go to your Dashboard:
    • Locate the "API Key" section
    • Copy your API key
    • New users get 100 free API calls
  3. API Usage Details:
    • Free tier: 100 searches per month
    • Paid plans start at $50/month for 5000 searches
    • Billing based on successful API calls
    • Multiple payment methods: Credit Card, PayPal, etc.
  4. Usage Limits:
    • Request Rate: 2 requests/second
    • IP Restrictions: None
    • Concurrent Requests: 5
    • Response Cache Time: 1 hour

👩‍🔧 Solution for MCP Servers Connection Issues with NVM/NPM

Click to view my configuration solution 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Quick Start

  1. Install dependencies:
npm install
  1. Configure environment: Modify your claude_desktop_config.json with the following content (adjust paths according to your system):
"google-news": { "command": "D:\\Program\\nvm\\node.exe", "args": [ "D:\\github_repository\\path_to\\dist\\index.js" ], "env": { "SERP_API_KEY": "your-api-key" } }
  1. Build the server:
npm run build
  1. Start the server:
npm start

Troubleshooting

  1. Invalid API Key
  • Verify API key configuration in claude_desktop_config.json
  • Confirm API key is active in SERP API dashboard
  1. Request Failures
  • Check network connectivity
  • Verify API call quota hasn't been exceeded
  • Validate request parameter format

📦 Installation

Installing via Smithery

To install Google News for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @chanmeng666/google-news-server --client claude

Installing via mcp-get

npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server

If you are using an old version of Windows PowerShell, you may need to run Set-ExecutionPolicy Bypass -Scope Process before this command.

Manual Installation

<img src="https://cdn.simpleicons.org/npm/CB3837" height="14"/> <a href="https://www.npmjs.com/package/@chanmeng666/google-news-server">@chanmeng666/google-news-server</a>

# Using npm npm i @chanmeng666/google-news-server # or npm install @chanmeng666/google-news-server # Using yarn yarn add @chanmeng666/google-news-server # Using pnpm pnpm add @chanmeng666/google-news-server

💻 Tech Stack

📖 API Documentation

The server implements the Model Context Protocol and exposes a Google News search tool with the following parameters:

  • q: Search query string
  • gl: Country code (e.g., 'us', 'uk')
  • hl: Language code (e.g., 'en', 'es')
  • topic_token: Token for specific news topics
  • publication_token: Token for specific publishers
  • story_token: Token for full coverage of a story
  • section_token: Token for specific sections

🔧 Development

# Run in development mode with hot reload npm run dev # Run linting npm run lint # Run tests npm run test

📝 License

This project is MIT licensed.

🙋‍♀ Author

Created and maintained by Chan Meng.

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Login with GitHub to review

Rate & Review

Star IconStar IconStar IconStar IconStar Icon

Alternative MCP servers

  • mcp-guide

    A
    security
    A
    license
    A
    quality
    A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
    Last updated December 19, 2024
    Apache License 2.0

  • pubmed_search

    A
    security
    A
    license
    A
    quality
    Server to search PubMed (PubMed is a free, online database that allows users to search for biomedical and life sciences literature). I have created on a day MCP came out but was on vacation, I saw someone post similar server in your DB, but figured to post mine.
    Last updated December 12, 2024
    MIT License
    • Apple

  • arxiv-mcp-server

    A
    security
    A
    license
    A
    quality
    The ArXiv MCP Server bridges the gap between AI models and academic research by providing a sophisticated interface to arXiv's extensive research repository. This server enables AI assistants to perform precise paper searches and access full paper content, enhancing their ability to engage with scientific literature.
    Last updated January 2, 2025
    Apache License 2.0