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.5.tar.gz (34.0 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.5-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_server_google_news-0.1.5.tar.gz
  • Upload date:
  • Size: 34.0 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.5.tar.gz
Algorithm Hash digest
SHA256 dafb42649389af9d86df90036fecf11318c395a3b83132e5a76a229bed41bedf
MD5 9ee365d4041e9177a6960f7371bdf79f
BLAKE2b-256 9480bf3f2b95c89f69a5eeb251c75362311e15b4269da3777744c6554bda9824

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_server_google_news-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 3614a0deb540e676b1a6bcb675a0a0dfb569c5cf81284964d53bbc7345cdb809
MD5 50aa15ee14e0e547080469604098aa84
BLAKE2b-256 b657789745f73e1e871a5f3489673d99745de83a170a7dc721477df42ace0169

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