Google Search Console Connector

io.github.malaysherasia-aiPublished by GitHub account malaysherasia-aiv0.1.3Updated Nov 2, 2026

Google Search Console: search analytics, CSV reports, URL inspection, sitemaps, site verification.

VerifiedSTDIODesktop onlyWeb Search & ScrapingDeveloper ToolsData & Analytics

Overview

AI-generated overview

Local MCP server that connects an assistant to Google Search Console for search analytics, URL inspection, sitemaps, site verification and CSV report exports.

What you can do
  • Query Search Analytics performance data by date, query, page, country, device, hour or search type, with regex filters and branded/non-branded splits
  • Export full reports (CSV, JSON, Markdown summary) for one site or all sites, paging past Google's row limits
  • Inspect URLs for index status, last crawl, canonical and rich results
  • List, submit and delete sitemaps
  • Add properties and verify ownership by meta tag, HTML file or DNS
  • Manage connection, brand terms, chart annotations and open a local SEO dashboard
When to use it
Useful when you build or maintain websites and want an assistant to answer SEO questions from real Search Console data, pull reports without manual CSV exports, or diagnose indexing problems and verify new properties.
Requirements
Runs locally via npx, so Node.js 20 or newer is needed. A Google account with access to Search Console; sign-in uses Google OAuth in the browser, with no API keys required. Optional environment variables: GSC_PROJECT_DIR, GSC_CLIENT_ID and GSC_CLIENT_SECRET for your own OAuth client, GSC_CONNECT_HOME, GSC_CONNECT_PORT. Network access to Google and the npm registry.
Before you install
Sign-in grants the webmasters scope and, on first site verification, siteverification; tokens are stored under ~/.gsc-connect. Some tools write to Google: submitting or deleting sitemaps, adding properties, verifying ownership. Reports are written into the project folder. Anonymous usage metrics are opt-in and can be disabled with GSC_CONNECT_TELEMETRY=0 or DO_NOT_TRACK=1; a daily npm update check can be disabled with GSC_CONNECT_UPDATE_CHECK=0.

Installation

In SourceWeft

  1. Open Google Search Console Connector in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Google Search Console Connector for Claude Code

Connect any website project to Google Search Console from Claude Code, Google Antigravity or any MCP client. Sign in with your Google account once, then ask Claude about clicks, queries, rankings and indexing, pull every GSC report as CSV with one command, and track it all in a local SEO dashboard.

It's an open-source Search Console MCP server, a GSC report exporter and a dashboard, and it runs entirely on your computer. No Google Cloud setup, no API keys: you just sign in with Google.

[npm] [License: MIT] [Node.js 20+]

[Demo of the Google Search Console connector: Claude Code answers "How did my site do this week?" with Search Console clicks, rankings and a fix to make; one command exports every GSC report as CSV; the local SEO dashboard shows the clicks trend and striking-distance keyword opportunities]

If you find it useful, a ⭐ on GitHub helps other people find it.

Docs and updates: claude-repo.com/google-search-console-connector

Why this exists

If you build sites with an AI coding agent, getting Search Console data into it usually means logging in to search.google.com, clicking Export, downloading CSVs and dragging them into the chat. Every site, every time.

This tool removes those steps:

npx google-search-console-connector report

That one command downloads the same reports as Search Console's Export button (Dates, Queries, Pages, Countries, Devices, Search appearance) plus comparisons with the previous period, query-to-page pairs, sitemaps, and a summary.md written for Claude to read. Inside Claude Code you don't even type it. Ask "pull the Search Console report" and Claude runs the gsc_export_report tool.

Features

  • Sign in with Google. One click in your browser, using Google's own OAuth 2.0 (PKCE). No Google Cloud project, API keys or passwords.
  • One-command GSC export. Pull CSV, JSON and Markdown reports for one site or all your sites (--all-sites), for any range up to 16 months.
  • MCP server for Claude Code and Antigravity. 18 tools: performance data, hourly data, branded vs non-branded queries, URL Inspection, sitemaps, adding properties and verifying ownership.
  • Local SEO dashboard. KPIs against the previous period, a trend chart (hourly, daily, weekly, monthly), queries, pages, countries, devices, sitemaps and URL Inspection. Light and dark themes.
  • Opportunities. Striking-distance keywords (positions 4–20), page-one pages with low CTR, and queries that are losing clicks.
  • Branded vs non-branded. Set your brand terms once; the dashboard, reports and Claude can all split traffic by them.
  • Chart notes. Claude can mark the chart when it ships SEO changes ("Rewrote service page titles"), so you can see what moved the numbers.
  • Site verification. Claude can add a new site to Search Console, put the verification meta tag in your code, and verify it after you deploy.
  • Current with Google. Supports the latest Search Console API features, including hourly data, Discover and Google News. A weekly check flags new API fields and Search Central announcements.
  • Private by default. Tokens and Search Console data stay on your machine and go only to Google. There is no server in between.

Quick start

You need Node.js 20 or newer and a Google account with access to Search Console.

1. Add it to Claude Code (once, for all your projects):

bash
claude mcp add gsc --scope user -- npx -y google-search-console-connector@latest

On Windows, wrap npx in cmd /c:

bash
claude mcp add gsc --scope user -- cmd /c npx -y google-search-console-connector@latest

To run the latest code straight from GitHub instead of npm, use npx -y github:malaysherasia-ai/google-search-console-connector-for-claude-code in place of npx -y google-search-console-connector@latest. The first start takes about 20 seconds while it builds. GitHub builds don't include the one-click sign-in client, so you'll need your own Google Cloud OAuth client (the Connect page walks you through it).

2. Connect a website project. Open Claude Code in the website's folder and say:

Connect this project to Google Search Console

Claude calls gsc_connect, which opens a page in your browser:

  1. a one-time question about anonymous usage metrics (yes or no, your choice),
  2. Sign in with Google with the account that has your Search Console access. On Google's second screen, tick the box next to "View and manage Search Console data for your verified sites" before you click Continue; Google leaves it unticked,
  3. pick which Search Console property belongs to this project.

[Connect page: Sign in with Google, with a reminder to tick the Search Console box on Google's screen]

What Google shows you (account details hidden):

[Google's sign-in for Search Console Connector: choose your account and click Continue, then tick the Search Console box and click Continue]

That's it. Google has verified the app's branding and it only asks for non-sensitive permissions, so there's no "unverified app" screen to click through. If you continue without ticking the box, the connector keeps your previous sign-in and asks you to try again.

3. Ask away:

How did the site do in the last 28 days? Which queries are we ranking 4–20 for, and which pages should we improve? Pull the GSC report for the last 3 months. Inspect https://example.com/services/ and tell me why it isn't indexed. Submit the sitemap, then add a chart note that we launched the new location pages. Open the Search Console dashboard.

You can also run everything from a terminal:

bash
npx google-search-console-connector connect     # browser setup and sign-innpx google-search-console-connector report      # export reports to .gsc-reports/npx google-search-console-connector dashboard   # open the local dashboardnpx google-search-console-connector demo        # try the dashboard with sample data

Use with Google Antigravity, Cursor and other MCP clients

Any MCP client that can start a local (stdio) server works. Add this to its MCP configuration (in Antigravity, open the MCP servers settings and edit the raw config):

json
{  "mcpServers": {    "google-search-console": {      "command": "npx",      "args": ["-y", "google-search-console-connector@latest"]    }  }}

The server uses the folder it is started in as the project. If your client starts servers somewhere else, set "env": { "GSC_PROJECT_DIR": "/path/to/your/site" }.

Advanced: use your own Google Cloud project

Most people can skip this. Agencies and developers who want sign-in to run through their own Google Cloud project (their own quota, their own consent screen) can choose Use my own Google Cloud project on the sign-in page. The steps are:

  1. Create a Google Cloud project, or pick an existing one.
  2. Enable the Google Search Console API.
  3. Enable the Site Verification API (used to verify new sites).
  4. Configure the consent screen: choose External and add your email as a test user. Then publish the app to In production. Apps left in "Testing" have their sign-in expire every 7 days. You don't need Google's app verification for your own use; Google will show an "unverified app" notice, and you continue with Advanced → Go to (your app).
  5. Create an OAuth client ID of type Desktop app, download the JSON, and drop it on the Connect page.

Both APIs are free. Your own client means quota and the consent screen are yours. To go back to the built-in sign-in, use the link at the top of that page, or Settings in the dashboard.

One-command Search Console reports

bash
npx google-search-console-connector report [--days 28] [--type web] [--site URL] [--all-sites] [--out DIR]
FileContents
summary.mdTotals against the previous period, branded split, top queries and pages, biggest gains and losses, striking-distance keywords and low-CTR pages
Dates.csv, Queries.csv, Pages.csv, Countries.csv, Devices.csv, Search appearance.csvThe same columns as Search Console's Export, plus previous-period columns
Query-page pairs.csvWhich page ranks for which query (Search Console's UI can't export this)
Sitemaps.csvSubmitted sitemaps, status, errors and warnings
Filters.csv, report.jsonExactly what was requested, and all data as JSON

Reports go to .gsc-reports/<site>/<date>_last-<n>-days/ in your project, and .gsc-reports/ is added to .gitignore so search data never ends up in a commit or a deployed site. Rows page past Google's 25,000-row limit automatically.

MCP tools

ToolWhat it does
gsc_connectOpens the browser Connect flow and waits for it to finish
gsc_status / gsc_disconnectConnection status; revoke access
gsc_list_sites / gsc_link_projectList properties; set this project's default property
gsc_performance_summaryTotals against the previous period, plus top queries and pages
gsc_search_analyticsAny Search Analytics query: dimensions including hour, filters (regex), search type, branded/non-branded
gsc_export_reportThe one-command report export, for one site or all sites
gsc_inspect_urlURL Inspection: index status, last crawl, canonical, rich results
gsc_list_sitemaps / gsc_submit_sitemap / gsc_delete_sitemapManage sitemaps
gsc_add_site / gsc_get_verification_token / gsc_verify_siteAdd a property and verify ownership (meta tag, HTML file or DNS)
gsc_set_brand_termsWords that make a query "branded"
gsc_add_annotationAdd a dated note to the performance chart
gsc_open_dashboardOpen the local dashboard

The dashboard

npx google-search-console-connector dashboard, or ask Claude to open it. It runs on 127.0.0.1 only and opens through a one-time link.

  • Overview: clicks, impressions, CTR and position against the previous period, with a trend chart for the last 24 hours (hourly) through 16 months, grouped daily, weekly or monthly
  • Queries and Pages: sortable, searchable, change columns, CSV export
  • Opportunities: striking distance, low CTR, declining queries
  • Sitemaps & inspection: submit sitemaps, check their status, inspect any URL
  • Settings: account, project property, brand terms, chart notes, usage-metrics choice
[Opportunities: striking distance keywords and low CTR pages][Dashboard with a 3-month trend and chart notes]
[Hourly Search Console data for the last 24 hours][Sitemaps status and URL Inspection]

Try it without a Google account: npx google-search-console-connector demo.

What Google's API does and doesn't expose

Search Console keeps adding features. Some reach the API and some stay in the web UI. This table reflects Google's API as of October 2026.

Search Console featureSupported hereNotes
Performance: clicks, impressions, CTR, position by date, query, page, country, device, search appearanceYes
Hourly data (last ~10 days)Yeshour dimension, "24h" range in the dashboard
Discover and Google News performanceYesGoogle doesn't report queries or positions for these
Branded vs non-branded queriesYesBuilt from your brand terms with RE2 regex filters
Weekly and monthly viewsYesGrouped from daily data
Chart annotationsYes, locallyStored in .gsc-connect.json; Google's own annotations aren't in the API
AI Overviews and AI ModeIncluded in Web totalsGoogle's API can't separate them
Generative AI performance report, web multimodal search type, social platform properties, query groupsNot yetUI-only in Search Console today. The update check flags them as soon as Google adds them to the API

Privacy and anonymous usage metrics

  • Your Search Console data never leaves your computer, except to go between you and Google.
  • Tokens are stored in ~/.gsc-connect/ with owner-only file permissions. Disconnecting revokes them at Google.
  • Project settings (.gsc-connect.json: property, brand terms, chart notes) contain no secrets and are safe to commit.
  • Anonymous usage metrics are opt-in. The first screen asks once. If you say no, nothing is ever sent. If you say yes, the app sends event names such as view_changed or mcp_tool_called with the app version, operating system and a random install ID to Google Analytics 4 via the Measurement Protocol. It never sends site URLs, page URLs, queries, metrics or your account. No tracking script runs in your browser and no cookies are set. Settings → "What's been sent" shows every event exactly as it was sent, and you can change your answer there at any time. DO_NOT_TRACK=1 or GSC_CONNECT_TELEMETRY=0 turns it off for good. The full list of events is in src/telemetry.ts.
  • Update check: once a day the app asks the public npm registry for the latest version number. Set GSC_CONNECT_UPDATE_CHECK=0 to turn it off.

Security

  • The local server listens on 127.0.0.1 only, checks the Host header, and requires a session cookie that is set through a one-time launch link.
  • OAuth uses the loopback redirect with PKCE (S256) and a state check, as Google recommends for desktop apps.
  • Requested at sign-in: webmasters (Search Console) and openid email (to show which account is connected). siteverification is asked for separately, only the first time you verify a new site.

Report vulnerabilities privately; see SECURITY.md.

Configuration

VariablePurpose
GSC_PROJECT_DIRProject folder, if your MCP client starts servers elsewhere
GSC_CLIENT_ID, GSC_CLIENT_SECRETUse your own OAuth client from the environment instead of the built-in sign-in
GSC_CONNECT_HOMEWhere credentials are stored (default ~/.gsc-connect)
GSC_CONNECT_PORTPreferred local port (default 4817; falls back to any free port)
GSC_CONNECT_TELEMETRY=0, DO_NOT_TRACK=1Never send usage metrics
GSC_CONNECT_UPDATE_CHECK=0Don't check npm for new versions

FAQ

Is the Google Search Console API free? Yes. Google charges nothing for the Search Console API or the Site Verification API, and this tool has no paid parts.

Do I need a Google Cloud account? No. You sign in with the Google account you already use for Search Console. Your own Google Cloud project is an optional advanced setting.

Who can see my data? Only you and Google. The sign-in grants access to your computer, not to a server: tokens are stored in ~/.gsc-connect/ and reports are saved in your project folder. See the privacy policy.

Can I export more than 1,000 rows? Yes. Search Console's web export stops at 1,000 rows. The API returns up to 25,000 per request, and this tool keeps paging, up to Google's limit of 50,000 rows per day per search type.

Does it work with domain properties (sc-domain:)? Yes, domain properties and URL-prefix properties both work. Domain properties are verified by DNS.

Will it work with more than one website? Yes. Each project folder links to its own property, and report --all-sites exports every property you can access.

How do I update? If you installed with @latest, restart Claude Code. The dashboard and CLI tell you when a new version is out.

Development

bash
git clone https://github.com/malaysherasia-ai/google-search-console-connector-for-claude-code.gitcd google-search-console-connector-for-claude-codenpm installnpm run buildnpm run demo                                  # dashboard with sample dataclaude mcp add gsc-dev -- node "$PWD/dist/index.js"npm run check:google                          # what has Google changed since the last release?

See RELEASING.md for how releases are planned from Google's changes and from usage, and CONTRIBUTING.md for how to contribute.

License

MIT. Not affiliated with or endorsed by Google. Google Search Console is a trademark of Google LLC.

Source: README.md at commit cb358e2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestOct 19, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts