Google News MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Google News: 16 typed functions through one MCP server. No Google News API key needed.

Functions
16
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Google News

An MCP server for Google News alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/google_news
Every site

One MCP server for Google News and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 14
  • getForYouThe personalised For You feed.

    Arguments

    None.

    Returns GoogleNewsStory[]

    interface GoogleNewsStory {
      storyId: string;
      title: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/getForYou

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.getForYou();
  • getFullCoverageGoogle News' Full Coverage for one story.

    Arguments

    NameTypeRequired
    storyIdstringYes
    locale.hlstringNo
    locale.glstringNo
    locale.ceidstringNo

    Returns GoogleNewsFullCoverage

    interface GoogleNewsCoverageArticle {
      articleId: string;
      title: string;
      snippet: string | null;
      publisher: string;
      publisherUrl: string | null;
      url: string;
      publishedAt: string | null;
    }
    
    interface GoogleNewsFullCoverage {
      storyId: string;
      articles: GoogleNewsCoverageArticle[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/getFullCoverage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.getFullCoverage("CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2ptcGVQdkVSRlhvTmp0Z0F3RWppZ0FQAQ");
  • getTopicHeadlinesThe headlines under any Google News topic id.

    Arguments

    NameTypeRequired
    topicIdstringYes
    locale.hlstringNo
    locale.glstringNo
    locale.ceidstringNo

    Returns GoogleNewsTopicFeed

    interface GoogleNewsClusterEntry {
      title: string;
      link: string;
      publisher: string;
    }
    
    interface GoogleNewsArticle {
      articleId: string;
      title: string;
      link: string;
      publisher: string;
      publisherUrl: string | null;
      publishedAt: string | null;
      cluster: GoogleNewsClusterEntry[];
    }
    
    interface GoogleNewsTopicFeed {
      topicId: string;
      title: string;
      articles: GoogleNewsArticle[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/getTopicHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.getTopicHeadlines("CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB");
  • listEditionsThe country and language editions Google News publishes.

    Arguments

    None.

    Returns GoogleNewsEdition[]

    interface GoogleNewsEdition {
      hl: string;
      gl: string;
      ceid: string;
      label: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listEditions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listEditions();
  • listFollowedTopicsThe topics, places and publishers the signed-in person follows, exactly as Google News' own Following page lists them.

    Arguments

    None.

    Returns GoogleNewsFollowedTopic[]

    interface GoogleNewsFollowedTopic {
      name: string;
      topicId: string | null;
      kind: "topic" | "place" | "publisher";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listFollowedTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listFollowedTopics();
  • listLocalHeadlinesWhat is being reported in one place.

    Arguments

    NameTypeRequired
    placestringYes
    locale.hlstringNo
    locale.glstringNo
    locale.ceidstringNo

    Returns GoogleNewsLocalHeadlines

    interface GoogleNewsClusterEntry {
      title: string;
      link: string;
      publisher: string;
    }
    
    interface GoogleNewsArticle {
      articleId: string;
      title: string;
      link: string;
      publisher: string;
      publisherUrl: string | null;
      publishedAt: string | null;
      cluster: GoogleNewsClusterEntry[];
    }
    
    interface GoogleNewsLocalHeadlines {
      place: string;
      title: string;
      articles: GoogleNewsArticle[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listLocalHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listLocalHeadlines("Seattle");
  • listPublisherHeadlinesEverything Google News has indexed from one publisher.

    Arguments

    NameTypeRequired
    publisherstringYes
    querystringNo
    locale.hlstringNo
    locale.glstringNo
    locale.ceidstringNo

    Returns GoogleNewsPublisherHeadlines

    interface GoogleNewsClusterEntry {
      title: string;
      link: string;
      publisher: string;
    }
    
    interface GoogleNewsArticle {
      articleId: string;
      title: string;
      link: string;
      publisher: string;
      publisherUrl: string | null;
      publishedAt: string | null;
      cluster: GoogleNewsClusterEntry[];
    }
    
    interface GoogleNewsSearchArticle extends GoogleNewsArticle {
      headlineMatches: string[];
    }
    
    interface GoogleNewsPublisherHeadlines {
      publisher: string;
      query: string;
      articles: GoogleNewsSearchArticle[];
      truncatedBefore?: string;
      resumeBefore?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listPublisherHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listPublisherHeadlines("reuters.com", "tesla");
  • listSavedArticlesThe articles the signed-in person saved for later.

    Arguments

    None.

    Returns GoogleNewsSavedArticle[]

    interface GoogleNewsSavedArticle {
      title: string;
      publisher: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listSavedArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listSavedArticles();
  • listStoriesThe story clusters Google News is running right now, as ids.

    Arguments

    NameTypeRequired
    topicIdstringNo
    locale.hlstringNo
    locale.glstringNo
    locale.ceidstringNo

    Returns GoogleNewsStory[]

    interface GoogleNewsStory {
      storyId: string;
      title: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listStories("CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB");
  • listTopicHeadlinesThe latest headlines in one of Google News' own eight sections.

    Arguments

    NameTypeRequired
    sectionstringYes
    locale.hlstringNo
    locale.glstringNo
    locale.ceidstringNo

    Returns GoogleNewsTopicHeadlines

    interface GoogleNewsClusterEntry {
      title: string;
      link: string;
      publisher: string;
    }
    
    interface GoogleNewsArticle {
      articleId: string;
      title: string;
      link: string;
      publisher: string;
      publisherUrl: string | null;
      publishedAt: string | null;
      cluster: GoogleNewsClusterEntry[];
    }
    
    interface GoogleNewsTopicHeadlines {
      section: "World" | "Nation" | "Business" | "Technology" | "Entertainment" | "Sports" | "Science" | "Health";
      title: string;
      articles: GoogleNewsArticle[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listTopicHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listTopicHeadlines("Technology");
  • listTopicsThe topics Google News' own home-page nav rail is offering today.

    Arguments

    NameTypeRequired
    hlstringNo
    glstringNo
    ceidstringNo

    Returns GoogleNewsTopic[]

    interface GoogleNewsTopic {
      topicId: string;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/listTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.listTopics();
  • resolveArticleUrlThe publisher's real article URL behind a Google News link.

    Arguments

    NameTypeRequired
    articleIdOrLinkstringYes

    Returns GoogleNewsArticleResolution

    interface GoogleNewsArticleResolution {
      articleId: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/resolveArticleUrl

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.resolveArticleUrl("<articleIdOrLink>");
  • searchNewsEverything Google News has indexed about a subject, across every publisher at once.

    Arguments

    NameTypeRequired
    querystringYes
    locale.hlstringNo
    locale.glstringNo
    locale.ceidstringNo

    Returns GoogleNewsSearchResult

    interface GoogleNewsClusterEntry {
      title: string;
      link: string;
      publisher: string;
    }
    
    interface GoogleNewsArticle {
      articleId: string;
      title: string;
      link: string;
      publisher: string;
      publisherUrl: string | null;
      publishedAt: string | null;
      cluster: GoogleNewsClusterEntry[];
    }
    
    interface GoogleNewsSearchArticle extends GoogleNewsArticle {
      headlineMatches: string[];
    }
    
    interface GoogleNewsSearchResult {
      query: string;
      articles: GoogleNewsSearchArticle[];
      truncatedBefore?: string;
      resumeBefore?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/searchNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.searchNews("tesla");
  • topStoriesWhat Google News is leading with right now.

    Arguments

    NameTypeRequired
    hlstringNo
    glstringNo
    ceidstringNo

    Returns GoogleNewsTopStories

    interface GoogleNewsClusterEntry {
      title: string;
      link: string;
      publisher: string;
    }
    
    interface GoogleNewsArticle {
      articleId: string;
      title: string;
      link: string;
      publisher: string;
      publisherUrl: string | null;
      publishedAt: string | null;
      cluster: GoogleNewsClusterEntry[];
    }
    
    interface GoogleNewsTopStories {
      title: string;
      clusters: GoogleNewsArticle[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/topStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.topStories();
Act 2
  • followTopicFollow a topic, a place or a publisher as the signed-in person.

    Arguments

    NameTypeRequired
    topicIdstringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/followTopic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.followTopic("<topicId>");
  • saveArticleSave an article to the signed-in person's own reading list.

    Arguments

    NameTypeRequired
    articleHandlestringYes

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_news/saveArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_news.saveArticle("<articleHandle>");

Use it from code