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.6.tar.gz (34.4 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.6-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_server_google_news-0.1.6.tar.gz
  • Upload date:
  • Size: 34.4 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.6.tar.gz
Algorithm Hash digest
SHA256 b57d3a2ade10b836f299a0d55661b95b4840cbab8c1a8acb6ed250fcdce6d291
MD5 f5d5081af53f798e580ad5f9264e52a0
BLAKE2b-256 e435e09b0a053cbb20a082f0ae4d93473186680fd380395812a94a2c0bf15257

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_server_google_news-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 ec80878b04420f47888349b793eca202cf3d72507b6f0b17fec090057cca24b5
MD5 6795ba84ccbc6282c0377016867ba518
BLAKE2b-256 50df3b4c6f655886360398b86e722b8eca59606427970b0f42ee50b1bff066bf

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