Google Search Console MCP server

Google Search Console MCP Server

<!-- mcp-name: io.github.onlymoein/google-search-console-mcp -->

A local Model Context Protocol server that connects AI assistants (Claude Code, Claude Desktop, Cursor and any other MCP client) to the Google Search Console API. Ask about clicks, queries, pages, indexing and sitemaps in plain language; the server turns that into correct API calls and returns structured data.

It runs on your machine, talks only to Google, and stores nothing but your own login.

Unofficial. This project is not affiliated with or endorsed by Google. You use your own

Google Cloud credentials and are responsible for your usage under Google's terms.

Why this one

instead of an error: an invalid regex, a two-letter country code, hourly data older than ten days, a future date. Other combinations fail with a terse 400. Every one of these is checked before the call and explained in plain words. The rules are verified against the live API, not copied from blog posts.

• It catches the API's traps. Google answers many bad requests with an empty result

only asks Google for read-only access unless you need more.

• Read-only by default. Write tools do not exist unless you turn them on, and the login

fields, and every analytics result includes the exact request sent to Google.

• Structured output. Every tool declares an output schema, rows come back as named

pagination), hourly data, search appearances, URL inspection (single and concurrent batch), sitemaps and properties, plus a dedicated tool for each search surface (Discover, Images, video, news) that only accepts what that surface supports.

• Full API coverage: search analytics (all search types, filters, data states,

alike) and an async client, so batch inspection runs concurrently.

• Built on the current stack: MCP Python SDK 2.x (protocol 2026-07-28 and older clients

Quick start

You need uv and a Google account with access to at least one Search Console property.

project.

1. Create an OAuth client in Google Cloud (about five minutes, once):
2. Open console.cloud.google.com and create or pick a

test user, then click Publish app so the status is In production. Skip this and Google expires your login every 7 days.

1. APIs & Services > Library: enable the Google Search Console API.
2. Google Auth Platform > Branding: fill in an app name and your email.
3. Google Auth Platform > Audience: choose External, add your Google account as a

JSON and keep it outside any repository, for example ~/.config/open-gsc-mcp/client_secret.json.

1. Google Auth Platform > Clients > Create client: type Desktop app. Download the

1. Sign in (opens a browser once; the server itself never does):

uvx open-gsc-mcp auth login --client-file ~/.config/open-gsc-mcp/client_secret.json

Google shows "Google hasn't verified this app" because the app is yours and unreviewed; choose Advanced > Go to (your app). When it finishes, the command lists the properties it can see.

"Which queries lost the most clicks this month on example.com?"

1. Add the server to your client (below), restart the client, and ask something like

Shortened. The full README is on GitHub.