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.4.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.4-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_server_google_news-0.1.4.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.4.tar.gz
Algorithm Hash digest
SHA256 17d67213d99cf55754c57c7c42228eefc10268e32fb4b2b37dee02981988299e
MD5 eb4215a13bedb6313e3052702db56cc7
BLAKE2b-256 91fc44572e2acd55a383ce1e90126429465defd6f4f9eb30e2cd94bfb86bdd08

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_server_google_news-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 0472c0402b48ca7fd264b0db0b6feb3a0a83b77f70be9c1fd93234a6e38418fe
MD5 180c17b092d327f83cd67f08bf547a98
BLAKE2b-256 4fe24ee7880a2630bc75631c5f0b99844a5b869a27ea2666c89f92fec8cc0d35

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