Google Search Console MCP, inside your AI agent.

Connect your assistant to a local Google Search Console MCP. Analyze performance, explore queries, and inspect URLs.

curl -fsSL https://gscmcp.dev/install.sh | sh
Read the setup guideExplore use cases
  • 29 tools
  • Read-only by default
  • Runs locally
  • Provider-visible results

Works with the tools you already use

Use cases

Your Search Console data. Put to work.

Go from a question to evidence, inside the assistant you already use.

Performance

Understand what changed. And where.

Compare clicks and impressions across periods. Trace a traffic change to the pages and searches behind it.

Each comparison returns its date window and coverage; an overlapping update is timing only, never proof of cause.

Explore traffic changes
CodexIllustrative example

Compare the last 28 days with the previous period for sc-domain:example.com.

Clicks increased in this sample. Compare impressions and CTR to see what changed.

gsc_compare_periods
Illustrative performance response with sample data, not a live query.
MetricCurrentPreviousChange
Clicks12,54010,200+22.9%
Impressions245,231210,400+16.6%
CTR5.11%4.85%+0.26 pp

URL inspection

See your URL through Google's eyes.

Check the indexing state Google reports, along with coverage and sitemap information. Start an audit with evidence you can inspect.

Shows Google's reported status; inspecting a URL does not request or guarantee indexing.

Explore URL inspection
ClaudeIllustrative example

Is https://example.com/guide indexed? Check it for sc-domain:example.com.

Google reports this sample URL as submitted and indexed. Here is the reported evidence.

gsc_inspect_urls
Illustrative url inspection response with sample data, not a live query.
FieldReported value
URLhttps://example.com/guide
VerdictPASS
CoverageSubmitted and indexed
Canonicalhttps://example.com/guide

Queries & pages

Find the searches you can build on.

Discover queries with impressions but few clicks. Connect them to your pages and decide where to improve content.

Position is an impression-weighted average, not a rank tracker — read it as direction, not rank.

Explore search opportunities
CursorIllustrative example

Find high-impression, low-CTR queries for sc-domain:example.com over the last 28 days.

These sample queries have visibility but few clicks. They are starting points for a content review.

gsc_search_analytics
Illustrative queries & pages response with sample data, not a live query.
QueryClicksImpressionsCTRPosition
seo checklist1248,4201.5%8.2
technical seo866,1501.4%11.4
indexing guide573,8001.5%9.6
search analytics422,9101.4%12.3

Automation · full access

Submit your sitemap. Keep publishing moving.

Let your assistant notify Search Console about an updated sitemap. Enable full access only when you want it to make changes.

Sitemap submission requires full access and property permissions. It does not guarantee crawling or indexing.

Review write permissions
CodexIllustrative example

With full access enabled, submit https://example.com/sitemap.xml for sc-domain:example.com.

This sample shows a successful sitemap submission. Full access and property permissions are required; indexing is not guaranteed.

gsc_submit_sitemap
Illustrative automation · full access response with sample data, not a live query.
FieldSample response
siteUrlsc-domain:example.com
sitemapUrlhttps://example.com/sitemap.xml
successtrue
errornull

Sitemaps

Know what Google sees in your sitemaps.

List the sitemaps registered for your property. Check their reported errors and warnings before investigating individual URLs.

Listing sitemaps is read-only. A submitted sitemap is not proof that its pages are indexed.

Explore sitemaps
CursorIllustrative example

List the registered sitemaps, errors, and warnings for sc-domain:example.com.

One sample sitemap has a warning. Inspect its details before making changes.

gsc_list_sitemaps
Illustrative sitemaps response with sample data, not a live query.
SitemapErrorsWarnings
/sitemap.xml00
/sitemap-posts.xml01
/sitemap-pages.xml00

Reporting

Turn the week's data into a useful report.

Bring totals, movers, and opportunities into a Markdown report. Review its coverage and limitations before sharing it.

Server-generated Markdown export with a limitations section. Review the returned coverage before using it.

Explore weekly reports
CodexIllustrative example

Create a weekly report for sc-domain:example.com and include the limitations.

This sample weekly report organizes the evidence into four sections.

gsc_generate_report
Illustrative reporting response with sample data, not a live query.
Report sectionContents
OverviewTotals and period comparison
MoversPage and query changes
OpportunitiesQueries to investigate
LimitationsCoverage and date window

Examples use sample data for example.com. Your assistant returns the evidence for your own property.

Tools

Your Google Search Console MCP toolkit.

Four ways to put your Search Console data to work.

Explore all tools

Performance

Compare clicks, impressions and CTR to understand what changed.

Search opportunities

Find searches and pages with room to grow.

URL indexing

Check whether a page is indexed and investigate issues.

Sitemaps

Review your submitted sitemaps and spot errors or warnings.

See a question become evidence.

Choose a question and explore a sample answer from your agent.

Illustrative data for example.com. This demo makes no Google or AI calls.

Sample conversation
You

Did my traffic really drop — or just move?

CodexSample answer

Clicks increased in this sample. Compare impressions and CTR to see what changed.

gsc_compare_periodsExample tool result
Illustrative performance data for example.com, not a live query.
MetricCurrentPreviousChange
Clicks12,54010,200+22.9%
Impressions245,231210,400+16.6%
CTR5.11%4.85%+0.26 pp

Each comparison returns its date window and coverage; an overlapping update is timing only, never proof of cause.

Paste this question into your agent, then replace the example property with yours.

Local by design

Your machine. Your credentials. Your choice.

This MCP for Google Search Console runs locally, with permissions you control.

Credentials stay local

Tokens stay in ~/.gsc-mcp/ on your machine. This website never runs your queries or collects credentials.

Start with read-only

Quick Connect is read-only. Write operations require explicit full access and your own OAuth client or service account.

Know where answers go

Your MCP client and its AI provider see the tool results used to answer your questions.

Read the privacy details
Install with your AI agentCopy a prompt for Codex, Claude, Cursor, or another agent

Copy this prompt into your agent to install the package and connect your MCP client. Complete Google sign-in yourself in the browser.

Install with your AI agent

Install @sonnivasquez/gsc-mcp globally with npm (or Bun if I prefer), then run gsc setup. Use read-only Quick Connect. Help me sign in to Google, choose my Search Console property, and connect it to the MCP client you run in (detect it yourself; don't ask me to choose) without changing other MCP servers. When setup offers the agent skill screen, install it for the client you run in. Never ask me to paste credentials or tokens into chat. Run gsc doctor and tell me if I need to restart the client. Don't query Search Console until I ask.
Set up your local connectionRuntime, credentials, client configuration, and verification

Install, connect, and start with read-only access.

  1. STEP 1 OF 3

    Install once

    Choose curl, npm, or Bun above. Node.js 22 or newer runs gsc; Bun can install the package globally too.

  2. STEP 2 OF 3

    Connect Google

    Run Quick Connect, sign in in the browser, and choose the Search Console property you want to use. Quick Connect is read-only.

    Credential options →

  3. STEP 3 OF 3

    Connect your client

    Choose your MCP client in setup, review the configuration preview, and approve it. Restart an already-open client to load the new server.

    Client instructions →

Check your installation

gsc doctor

Questions before you connect.

Short answers from the docs. Longer versions live in the setup guide.

What is gsc-mcp?

A local MCP server that connects your Search Console data to the AI assistant you already use. It runs on your machine and talks to your assistant's client over a local connection — this website never runs your queries.

Which assistants can I connect?

Claude Desktop, Claude Code, Cursor, or Codex, and any other client that connects to a local MCP server. See client setup for the exact steps per client.

Do I need Google credentials?

You need a Google account with access to your Search Console property. Quick Connect uses Google sign-in for read-only access. Full access requires your own OAuth client or service account. Follow the credentials guide for your chosen connection.

Is gsc-mcp free?

The code is open source under Apache-2.0, with no gsc-mcp subscription. Your AI client or provider may charge separately.

What permissions does it request?

Read-only access is the default: it can read Search Console data and inspect URLs. Full access also enables sitemap changes and eligible Indexing API notifications. It does not request Gmail, Drive, or Analytics access. Review access modes and permissions before enabling writes.

Do credentials stay local?

Tokens are cached in ~/.gsc-mcp/ on your machine and sent to Google for authentication. Your MCP client and its AI provider see the tool results used to answer your questions — local means no backend of ours, not invisible answers.

Does inspecting a URL guarantee indexing?

No. The server reports Google's indexing state for a URL and the property sitemaps that include it. Inspecting a URL does not request indexing and never guarantees it.

How do I install and update the MCP?

Run npm install -g @sonnivasquez/gsc-mcp, then gsc setup. Run the install command again — or gsc update (gsc update --check only compares versions) — to update: updates never break a working install, and major changes migrate automatically with a backup. After updating, check gsc --version and restart your MCP client. To stay on a version or roll back, pin it (npm install -g @sonnivasquez/gsc-mcp@1.0.0). Updating or uninstalling never touches your Google tokens, profiles, or client configurations. Maintained by Sonni Vasquez (sonnivasquez.com).

Connect your Google Search Console MCP.

Read the guide, connect locally, and start with a question.

Get startedGitHub