Back to Browse

Gsc MCP Server

Developer ToolsModerate7.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for Google Search Console & Indexing API — search analytics, sitemaps, URL inspection

About

MCP server for Google Search Console & Indexing API — search analytics, sitemaps, URL inspection

Security Report

7.3
Moderate7.3Low Risk

Valid MCP server (2 strong, 4 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (10/10 approved).

3 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Google OAuth2 Client IDRequired

Environment variable: GSC_CLIENT_ID

Google OAuth2 Client SecretRequired

Environment variable: GSC_CLIENT_SECRET

Google OAuth2 Refresh TokenRequired

Environment variable: GSC_REFRESH_TOKEN

Path to Google service account JSON key fileOptional

Environment variable: GSC_SERVICE_ACCOUNT_KEY_PATH

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-mikusnuz-gsc": {
      "env": {
        "GSC_CLIENT_ID": "your-gsc-client-id-here",
        "GSC_CLIENT_SECRET": "your-gsc-client-secret-here",
        "GSC_REFRESH_TOKEN": "your-gsc-refresh-token-here",
        "GSC_SERVICE_ACCOUNT_KEY_PATH": "your-gsc-service-account-key-path-here"
      },
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

gsc-mcp

npm version

English | 한국어

MCP Badge

MCP server for Google Search Console API and Google Indexing API — full API coverage.

When to Use

TaskTool
"Check which queries my site ranks for"search_analytics_query
"Submit a URL for indexing"indexing_publish
"Find pages with indexing errors"url_inspection_inspect
"Get search performance data for the last 30 days"search_analytics_query
"Compare click-through rates between mobile and desktop"search_analytics_query (group by device)
"Submit my sitemap to Google"sitemaps_submit
"Batch submit URLs for indexing"indexing_batch_publish

For AI agents: See llms.txt for a machine-readable summary. Copy templates/CLAUDE.md or templates/AGENTS.md into your project to teach your agent about this MCP.

Unlike other GSC MCP servers that only wrap searchAnalytics.query, this server exposes every endpoint available in the Google Search Console and Indexing APIs.

Tools (13)

Sites

ToolDescription
sites_listList all sites (properties) in your Search Console
sites_getGet details of a specific site
sites_addAdd a new site (property)
sites_deleteRemove a site

Sitemaps

ToolDescription
sitemaps_listList all submitted sitemaps for a site
sitemaps_getGet details of a specific sitemap
sitemaps_submitSubmit a sitemap
sitemaps_deleteDelete a sitemap

Search Analytics

ToolDescription
search_analytics_queryQuery search performance data (clicks, impressions, CTR, position) with filtering and grouping. Supports hourly data with the hour dimension.

URL Inspection

ToolDescription
url_inspection_inspectInspect a URL's index status, crawl info, rich results, AMP, and mobile usability

Indexing API

ToolDescription
indexing_publishNotify Google about URL updates or removals
indexing_get_metadataGet latest notification status for a URL
indexing_batch_publishBatch notify Google about up to 100 URL updates/removals in a single request

Authentication

Two authentication methods are supported:

Option 1: OAuth2 Refresh Token

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Required OAuth2 scopes:

  • https://www.googleapis.com/auth/webmasters
  • https://www.googleapis.com/auth/indexing

Option 2: Service Account

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account-key.json"
      }
    }
  }
}

The service account must be added as an owner or user in Google Search Console for each site.

Setup Guide

OAuth2 Setup

  1. Go to Google Cloud Console
  2. Create a project (or select existing)
  3. Enable Search Console API and Indexing API
  4. Create OAuth 2.0 credentials (Desktop app type)
  5. Use the OAuth Playground to generate a refresh token with scopes:
    • https://www.googleapis.com/auth/webmasters
    • https://www.googleapis.com/auth/indexing

Service Account Setup

  1. Go to Google Cloud Console
  2. Create a service account
  3. Download the JSON key file
  4. Enable Search Console API and Indexing API
  5. In Search Console, add the service account email as an owner for your sites

License

MIT

Reviews

No reviews yet

Be the first to review this server!

Gsc MCP Server - MCP server for Google Search Console & Indexing API — | MCP Marketplace