Skip to main content
Glama
Sign In
googlenews-mcp

googlenews-mcp

by RobertDWhite
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

googlenews-mcp

MCP server in front of Google News, so agents without external internet access can still read the news: the agent talks only to this server, and this server talks only to news.google.com. It is a news gateway, not a web proxy — there is deliberately no fetch-arbitrary-URL tool.

  • Image: ghcr.io/robertdwhite/googlenews-mcp, built by CI in this repo.

  • Transport: MCP streamable HTTP at /mcp, bearer-gated by MCP_TOKEN. /healthz is open.

  • Upstream: Google News public RSS endpoints (no API key), plus the batchexecute RPC used only to decode article redirect URLs.

Tools

Tool

Does

top_headlines(language, country, count)

Front-page top stories

topic_headlines(topic, ...)

One section: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SCIENCE, SPORTS, HEALTH

search_news(query, when, ...)

Full-text search; supports Google News operators (site:, source:, after:/before:, "...", OR, -) and a when recency window (1h…1m)

geo_headlines(location, ...)

Local news for a city/region/country

decode_urls(urls)

Resolve news.google.com/rss/articles/... redirect links to real publisher URLs (best-effort, max 10/call)

Articles come back as {title, url, published, source, source_url, summary, related}; related carries other outlets' coverage when Google clusters a story.

Related MCP server: mcp-newsapi

Config (env)

Var

Meaning

MCP_TOKEN

Bearer token required on /mcp. Unset = unauthenticated (dev only).

PORT

Listen port (default 8080).

GNEWS_LANGUAGE / GNEWS_COUNTRY

Default locale (en / US).

GNEWS_TIMEOUT

Upstream timeout seconds (default 30).

Run locally

pip install -r requirements.txt
python server.py
curl localhost:8080/healthz

Deploy

Manifests live in whitehouse-rke2 under apps/ai/googlenews-mcp (namespace googlenews-mcp, endpoint https://googlenews-mcp.internal.white.fm/mcp, tailnet only).

Notes

  • decode_urls uses the same technique as the googlenewsdecoder package; Google changes that endpoint occasionally, so treat it as best-effort. The redirect URLs themselves also work directly in a normal browser.

  • Google clusters top-stories items; the per-item related list is parsed out of the RSS description HTML.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • News API MCP Server

    kcjonnyc
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to search news articles, get top headlines, and browse sources via the NewsAPI.org service.
    MIT

  • mcp-newsapi

    pipeworx-io
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables fetching top headlines and searching news archives from NewsAPI.org, allowing AI agents to access current and historical news data.
    351 npm
    MIT

  • MyNews MCP Server

    iamvazghen
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to fetch categorized news headlines and full article text from a multi-topic RSS aggregator, with no API keys required.
    9 npm
    ISC