How do I install Gsc?

Gsc is a local plugin. Install it using npm package: @mikusnuz/gsc-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Yes. Gsc passed MCP Marketplace's automated security scan with a score of 7.3/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Gsc need?

Gsc requires the following credentials or environment variables: GSC_CLIENT_ID, GSC_CLIENT_SECRET, GSC_REFRESH_TOKEN, GSC_SERVICE_ACCOUNT_KEY_PATH. You can find setup instructions on the server detail page.

What AI apps work with Gsc?

Gsc uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Gsc MCP Server

by Mikusnuz

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

English | 한국어

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

When to Use

Task	Tool
"Check which queries my site ranks for"	`search_analytics_query`
"Notify Google about an eligible job posting or livestream URL"	`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 notify eligible job posting/livestream URLs"	`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

Tool	Description
`sites_list`	List all sites (properties) in your Search Console
`sites_get`	Get details of a specific site
`sites_add`	Add a new site (property)
`sites_delete`	Remove a site

Sitemaps

Tool	Description
`sitemaps_list`	List all submitted sitemaps for a site
`sitemaps_get`	Get details of a specific sitemap
`sitemaps_submit`	Submit a sitemap
`sitemaps_delete`	Delete a sitemap

Search Analytics

Tool	Description
`search_analytics_query`	Query search performance data (clicks, impressions, CTR, position) with filtering and grouping. Supports hourly data with the `hour` dimension.

URL Inspection

Tool	Description
`url_inspection_inspect`	Inspect a URL's index status, crawl info, rich results, and AMP (the deprecated mobile-usability field may be absent)

Indexing API

Tool	Description
`indexing_publish`	Notify Google about an eligible `JobPosting` or `BroadcastEvent` URL update/removal
`indexing_get_metadata`	Get latest notification metadata for an eligible URL (requires `contentType`; not index status)
`indexing_batch_publish`	Batch notify up to 100 eligible URLs and report every embedded request status

Indexing API eligibility: Google supports this API only for pages with JobPosting structured data or livestream pages with BroadcastEvent embedded in a VideoObject. The tools require contentType so callers must identify which supported type applies. A successful API response confirms receipt of the notification; it does not guarantee that Google indexed the URL. Use url_inspection_inspect to check index status. See Google's Indexing API usage guide.

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

For Search Console read/write tools, add the service account as an owner or user with sufficient permission. For Indexing API tools, Google requires the service account to be added as a delegated owner of the property; user-level access is not sufficient.

Setup Guide

OAuth2 Setup

Go to Google Cloud Console
Create a project (or select existing)
Enable Search Console API and Indexing API
Create OAuth 2.0 credentials (Desktop app type)
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

Go to Google Cloud Console
Create a service account
Download the JSON key file
Enable Search Console API and Indexing API
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!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Gsc MCP Server

About

Security Report

Findings (4)Action required

Permissions Required

What You'll Need

How to Install

Documentation

gsc-mcp

When to Use

Tools (13)

Sites

Sitemaps

Search Analytics

URL Inspection

Indexing API

Authentication

Option 1: OAuth2 Refresh Token

Option 2: Service Account

Setup Guide

OAuth2 Setup

Service Account Setup

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MCP Marketplace

MarkItDown