Skip to main content

Google News MCP server for fetching news articles

Project description

MCP Server Google News

A Model Context Protocol (MCP) server for fetching Google News articles with configurable language and region settings.

Available Tools

google_news_search

Search for news articles using a query.

Parameters:

  • query (string, required): Search query
  • limit (int, optional): Number of articles to fetch (default: 10)
  • hl (string, optional): Language code (default: "ja")
  • gl (string, optional): Geographic location code (optional)

google_news_topics

Get news articles by topic.

Parameters:

  • topic_id (string, optional): Topic ID (default: TOP)
  • limit (int, optional): Number of articles to fetch (default: 10)
  • hl (string, optional): Language code (default: "ja")
  • gl (string, optional): Geographic location code (optional)

Available Topics:

  • TOP: トップニュース (default)
  • NATION: 国内
  • WORLD: 国際
  • BUSINESS: ビジネス
  • TECHNOLOGY: テクノロジー
  • ENTERTAINMENT: エンタメ
  • SPORTS: スポーツ
  • SCIENCE: 科学
  • HEALTH: 健康

Language and Region Codes

Common Language Codes (hl parameter)

  • ja: Japanese (default)
  • en: English
  • zh-CN: Chinese
  • fr: French
  • de: German
  • es: Spanish
  • ko: Korean

Common Region Codes (gl parameter)

  • JP: Japan
  • US: United States
  • GB: United Kingdom
  • CN: China
  • FR: France
  • DE: Germany
  • KR: South Korea

Installation

Using uv (Recommended)

No special installation is required when using uv. You can run mcp-server-google-news directly using uvx.

Using PIP

Alternatively, you can install mcp-server-google-news using pip:

pip install mcp-server-google-news

After installation, you can run the script as follows:

mcp-server-google-news

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx
{
  "mcpServers": {
    "google-news": {
      "command": "uvx",
      "args": ["mcp-server-google-news"]
    }
  }
}

Configure for VS Code

For quick installation, use one of the one-click install buttons below...

Install with UV in VS Code

Command Line Options

You can specify the following options when running the server:

  • --sse: Enable Server-Sent Events transport (on/off)
  • --host: Server bind address (default: localhost)
  • --port: Server port number (default: 8000)
  • --log-level: Logging verbosity (debug, info, warning, error)

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_google_news-0.1.8.tar.gz (35.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_google_news-0.1.8-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_google_news-0.1.8.tar.gz.

File metadata

  • Download URL: mcp_server_google_news-0.1.8.tar.gz
  • Upload date:
  • Size: 35.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.28.1

File hashes

Hashes for mcp_server_google_news-0.1.8.tar.gz
Algorithm Hash digest
SHA256 2f398ada3476775ba3bed997659e8a9da6a7e50e9dac64cedc349b7e10ad1364
MD5 8996451e0b639af149e8b70976b791b0
BLAKE2b-256 c56343381636087e405104b1643a88d83b64e1fa8495588103b79d4c33ba804b

See more details on using hashes here.

File details

Details for the file mcp_server_google_news-0.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_google_news-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 99de35e2fd095966bc7e9ea084fb06fde62d09ab5ad0d60114227026b9524975
MD5 734365d3ec218c3ff9d949a6bc3bcde7
BLAKE2b-256 dc313803d24cc456517a63380dd7d53dad8ca1d93ff8d34f99b4e4a4c021ad21

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page