Google Search Console Connector

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):

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

On Windows, wrap npx in cmd /c:

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:

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):

{  "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

npx google-search-console-connector report [--days 28] [--type web] [--site URL] [--all-sites] [--out DIR]

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

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

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.

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

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

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.