Google Search Console (GSC) MCP Server 🔍

Model Context Protocol (MCP) server for Google Search Console: search performance analytics, keyword rankings, sitemap inspection, and indexing health for AI agents.

🌐 Live Documentation & Web Portal: https://gsc.builditwithai.xyz

⚡ Quickstart

# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://gsc.builditwithai.xyz/install" | bash

# Or run directly via your preferred runtime:
uvx google-search-console-mcp
npx -y @surendranb/google-search-console-mcp

🤖 Client Setup

A. Claude Code (CLI)

claude mcp add google-search-console -- uvx google-search-console-mcp

B. Cursor & Google Antigravity (`mcp.json`)

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"]
    }
  }
}

C. Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
      }
    }
  }
}

D. VS Code (Cline / Roo Code / Continue)

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "@surendranb/google-search-console-mcp"]
    }
  }
}

🛠️ Tools & Capabilities

Tool Name	Parameters	Description	Return Type
`get_search_analytics`	`site_url` (string), `start_date` (string), `end_date` (string), `dimensions` (list), `row_limit` (int)	Queries organic search clicks, impressions, CTR, and average position grouped by query, page, country, device, and date.	`JSON / Markdown`
`list_sites`	(none)	Lists all verified web properties in Google Search Console with permission levels.	`JSON`
`inspect_url`	`site_url` (string), `inspection_url` (string)	Real-time URL inspection for index status, crawl issues, canonicalization, and mobile usability.	`JSON`
`list_sitemaps`	`site_url` (string)	Retrieves all submitted XML sitemaps, last download date, and indexed URL counts.	`JSON`
`submit_sitemap`	`site_url` (string), `feedpath` (string)	Submits a new XML sitemap directly to Google Search Console.	`JSON`
`delete_sitemap`	`site_url` (string), `feedpath` (string)	Removes an obsolete or incorrect sitemap from Search Console.	`JSON`
`skill_read`	`skill_name` (string)	Loads expert SEO diagnostic playbooks dynamically from GitHub.	`Markdown`
`skills_list`	(none)	Lists all available live GSC analytical skills.	`JSON`

🔒 Telemetry & Privacy

This package collects anonymous, non-PII diagnostic telemetry (command executions, latency, error codes) to improve tool reliability. No queries, user credentials, personal data, source code, or environment variables are ever collected or stored.

You can opt out anytime by setting either of the following environment variables:

export DO_NOT_TRACK=1
# or
export MCP_TELEMETRY_OPT_OUT=1

📄 License

MIT License. See LICENSE for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

google_search_console_mcp-0.10.5.tar.gz (31.3 kB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

google_search_console_mcp-0.10.5-py3-none-any.whl (42.5 kB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file google_search_console_mcp-0.10.5.tar.gz.

File metadata

Download URL: google_search_console_mcp-0.10.5.tar.gz
Upload date: Aug 22, 2026
Size: 31.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for google_search_console_mcp-0.10.5.tar.gz
Algorithm	Hash digest
SHA256	`ef2ff90088334c682f1d0b2197c7efd19f992303bf4274de09dbd738f7c08dfd`
MD5	`432c3636c300ab6a4f6f2b16cff07afe`
BLAKE2b-256	`8eb1a9b2595e59e9cb1b6cae251ec2a063d351463991e6160046a714750ee850`

See more details on using hashes here.

Provenance

The following attestation bundles were made for google_search_console_mcp-0.10.5.tar.gz:

Publisher: publish.yml on surendranb/google-search-console-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: google_search_console_mcp-0.10.5.tar.gz
- Subject digest: ef2ff90088334c682f1d0b2197c7efd19f992303bf4274de09dbd738f7c08dfd
- Sigstore transparency entry: 2559961770
- Sigstore integration time: Aug 22, 2026
Source repository:
- Permalink: surendranb/google-search-console-mcp@6ce7663e245974f5f83f38b5802f739b41749ae6
- Branch / Tag: refs/tags/v0.10.5
- Owner: https://github.com/surendranb
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@6ce7663e245974f5f83f38b5802f739b41749ae6
- Trigger Event: release