Skip to content
MrKeyword
AI search

Google Search Console MCP: how to give Claude your Search Console data

Search Console holds the most direct record of how your site performs in Google: the queries, clicks, impressions and average positions. A Search Console MCP connection lets Claude or Cursor read that data while it answers you. This guide covers the options, how to set one up with MrKeyword, what you can ask, and the limits that come with Search Console data.

A search performance dashboard with charts of clicks and positions
The short version
  • We found no official Google Search Console MCP server. Google publishes an experimental MCP server for Google Analytics, not Search Console.
  • You have three routes: build your own on the Search Console API, use a community server after checking it yourself, or use an SEO tool that syncs Search Console and runs an MCP server, such as MrKeyword.
  • With MrKeyword, setup is: connect Search Console (read-only), create a token, and add one server to Claude Code, a Claude custom connector or Cursor.
  • Claude can then call tools such as get_search_queries (with filters like almost_there for positions 11–20), get_page_keywords and get_rankings.
  • Search Console keeps 16 months of data. MrKeyword backfills up to 16 months on the first sync and keeps its own stored copy after Google's window moves on.

Is there an official Google Search Console MCP server?

We found no official Google Search Console MCP server as of 29 October 2026. Google's Search Console API page describes querying search analytics, listing verified sites and managing sitemaps, and does not mention MCP. Google does publish an official MCP server for Google Analytics, marked experimental and read-only by default, but it reads Analytics properties, not Search Console queries or positions.

So “Search Console MCP” today means one of the options below, each of which sits between Claude and the Search Console API.

Your options for a Search Console MCP connection

You can build a server on the Search Console API yourself, run a community server, or use an SEO tool that syncs Search Console and runs its own MCP server. They differ in effort, in who holds your Google access, and in how much history is available.

Three ways to give Claude your Search Console data

OptionWhat it takesTrade-offs
Build your own on the Search Console APIA Google Cloud project, OAuth credentials, and code that wraps API calls as MCP toolsFull control; you maintain it, and it can only see what the API returns, so no history beyond Google's window unless you store it
A community serverInstall and run someone else's code with access to your Google accountOften quick to try; check the code, its maintainer and the Google scopes it asks for before you trust it. We have not verified any, so we do not name one
MrKeywordConnect Search Console to MrKeyword once, then add its hosted server to your client with a tokenDaily synced Search Console and Bing data, a stored history and ready-made tools; it reads only your own verified sites, with no backlink or competitor data
The first two talk to the Search Console API directly. MrKeyword answers from its own daily copy of your Search Console and Bing Webmaster Tools data.

If you are weighing SEO MCP servers more broadly, including ones with competitor and backlink data, see SEO MCP servers compared.

How to connect Search Console to Claude with MrKeyword

Connect Search Console to a MrKeyword site, create a read-only token, add the MCP server to your client, and ask a first question. The full walkthrough, with scopes, permissions and troubleshooting, is in the Claude SEO MCP setup guide; this is the short version.

  1. Connect Google Search Console

    Add your site in MrKeyword and connect its Search Console property. MrKeyword requests Google's read-only scope, webmasters.readonly, so it can read performance data but cannot change anything in Search Console. Connect Bing Webmaster Tools too if you want Bing positions. The first sync backfills up to 16 months, newest month first.

  2. Create a token

    Open Settings → Connections → API & MCP Tokens and create a token. Leave “Allow this token to make changes” unticked for a read-only token. The value starts with mk_ and is shown once. Any plan can create one, Free included.

  3. Add the server to your client

    The endpoint is https://app.mrkeyword.io/mcp with the header Authorization: Bearer mk_…. In Claude Code, run the command below, then /mcp. In Claude Desktop or claude.ai, go to Settings → Connectors → Add custom connector, enter the URL, choose no sign-in and add the request header authorization with Bearer mk_…; request-header connectors are still rolling out, so use Claude Code if the option is missing. In Cursor, add the server to .cursor/mcp.json with a url and headers.

  4. Ask a first question

    “List my sites in MrKeyword” calls list_sites, which returns the site ids every other tool needs.

Claude Code: add MrKeyword's MCP server

claude mcp add --transport http mrkeyword https://app.mrkeyword.io/mcp \
  --header "Authorization: Bearer mk_your_token"
Replace mk_your_token with your own token. The developer reference lists the exact values for every client.

What can you ask Claude about your Search Console data?

You can ask about your queries, pages, clicks, impressions, CTR and average positions, and Claude will call the matching MrKeyword tools to answer. These are example prompts and the tools they usually lead to, not recorded answers.

Search Console questions and the MCP tools behind them

Ask ClaudeTool and argumentsWhat comes back
“How did the site do in Search Console recently?”get_site_summaryClicks, impressions, CTR and average position for the covered date range, plus up to 20 pages with 20+ impressions at average positions 8–30
“Which queries am I on page two for?”get_search_queries, filter almost_thereReal queries from the last 28 days at average positions 11–20, with page, clicks, impressions and CTR
“What do I already rank on page one for?”get_search_queries, filter page_oneQueries at an average position of 10 or better
“Which queries get seen but not clicked?”get_search_queries, filter seen_not_clickedQueries with 20+ impressions, zero clicks and an average position of 20 or better: candidates for a better title and description
“What does this page rank for?”get_page_keywords with the page URLUp to 100 queries that brought the page impressions, biggest first
“Which tracked keywords moved this month, on Google or Bing?”get_rank_summary, get_rankings (7, 28 or 90 days; engine google or bing)Average position and change against the previous period, top-3 and top-10 counts, biggest gains and drops
“Show the history for this keyword.”get_keyword_history (up to 365 days)Daily clicks, impressions, CTR and average position, with any annotations
Tool names and limits from MrKeyword's MCP server on 29 October 2026. Your client's tool list is the authority for what your token can call.

The built-in find_keyword_opportunities prompt starts from near-miss Search Console queries, builds a shortlist and asks before spending any keyword lookups. For more, see rank tracking with Claude, keyword research with Claude and an SEO audit with Claude.

Want the shorter version?The Claude SEO page shows the one-line setup and the questions people ask most.

See SEO with Claude

How much Search Console history can Claude see?

Search Console itself keeps 16 months of data; MrKeyword stores its own copy, so a connected site's history stays available after Google's window moves on. Google's announcement of the new Search Console said the Performance report gives you 16 months of data. A server that calls the Search Console API directly can only see that window.

MrKeyword's first sync backfills up to 16 months, and later daily syncs add each finished day, so its copy keeps growing from there. The MCP tools read slices of it: get_search_queries covers the last 28 days, get_rankings 7, 28 or 90 days, and get_keyword_history up to 365 days for a tracked keyword.

Limits of Search Console data over MCP

The data is Google's own report of your site, with Google's gaps, delays and averages. Knowing them keeps Claude's answers honest.

  • Average positions, not live ranks. Position is an impression-weighted average across devices and locations for the period.
  • Recent days settle. MrKeyword's data stops about three days back, because Google finalises data after roughly three days.
  • Missing queries. Search Console only reports queries that earned impressions, and rare or privacy-filtered queries can be absent.
  • Daily caps per site. MrKeyword stores up to 2,000 pages and 5,000 queries per site per day; tracked keywords are fetched separately, so the cap does not affect them.
  • Rate limit. 120 MCP calls a minute per token.

What MrKeyword does not do

MrKeyword reads your own verified sites; it does not see other people's sites or change anything in Google.

  • No competitor rankings. Every position comes from your own Search Console or Bing property.
  • No backlink tools and no market-wide traffic numbers via MCP.
  • No live SERP checks. It never scrapes Google's results page.
  • No writes to Search Console or your site. The Google and Bing connections are read-only, and action tools change data inside MrKeyword only.
  • No free keyword volume. Volume comes from live Keyword Planner lookups, which use plan credits; Search Console queries cost nothing extra.

Need competitor or backlink data as well? Pair a first-party server with a web-scale one. SEO MCP servers compared sets out what Ahrefs, Semrush, SE Ranking and DataForSEO offer.

Be careful with community servers. A server that holds your Google credentials can read everything that account can. Check which scopes it asks for, and prefer read-only access.

Questions and answers

Google Search Console MCP questions

Is there an official Google Search Console MCP server?

We found none as of 29 October 2026. Google publishes an experimental MCP server for Google Analytics, and the Search Console API documentation does not mention MCP.

How do I connect Search Console to Claude?

Use an MCP server that can read Search Console. With MrKeyword, connect Search Console to your site, create a token in Settings, Connections, API and MCP Tokens, and add https://app.mrkeyword.io/mcp to Claude Code, a Claude custom connector or Cursor with the token in an Authorization header.

Can Claude change my Search Console settings through MrKeyword?

No. MrKeyword connects to Search Console with Google's read-only scope, and no MCP tool writes to Search Console or your website.

How far back can Claude see my Search Console data?

Search Console keeps 16 months. MrKeyword backfills up to 16 months on the first sync and keeps its own stored copy afterwards. The MCP tools read 28 days of queries, 7 to 90 days of rankings and up to 365 days of history per tracked keyword.

Does a Search Console MCP connection show live Google rankings?

No. Search Console reports average positions over a period. For a live view of the results page you need a SERP rank tracker.

About this article

Written by the MrKeyword team, who build an SEO workspace on first-party Search Console and Bing data. Outside facts link to their original source below. We update this page when the product or the sources change.

Sources

  1. Search Console API — Google for Developers: search analytics, sites, sitemaps; no mention of MCP
  2. Introducing the new Search Console — Google Search Central blog: 16 months of data
  3. Google Analytics MCP server — official, experimental, read-only by default
  4. Connect Claude Code to tools via MCP — claude mcp add and /mcp
  5. Get started with custom connectors using remote MCP — Anthropic Help Centre
  6. Model Context Protocol in Cursor — mcp.json locations and headers
  7. MrKeyword MCP developer reference — endpoint, tokens, tool list, scopes and limits
Keep reading

Put this into practice.

Related guides and tools for the same job.

Let Claude read your Search Console data.

Connect Google Search Console to MrKeyword, create a read-only token and add the MCP server to Claude or Cursor. Free plan for one website, no card; paid plans from $10 a month.