google-gsc-mcp — Claude Code MCP server: install guide
The google-gsc-mcp MCP server for Claude Code connects an agent to Google Search Console. Ask about search traffic, sitemaps, or whether URLs are indexed.
MIT ★ 5 updated 2026-11-16
claude mcp add --env WSP_CLIENT_ID=<WSP_CLIENT_ID> --env WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> --env WSP_OAUTH_FILE=<WSP_OAUTH_FILE> --env WSP_SERVICE_ACCOUNT_FILE=<WSP_SERVICE_ACCOUNT_FILE> --env WSP_ALLOW_WRITES=<WSP_ALLOW_WRITES> --transport stdio google-gsc-mcp -- npx -y google-gsc-mcpWhat google-gsc-mcp does
google-gsc-mcp exposes Google Search Console data to an MCP client. Its listed tools cover site discovery, clicks, impressions, CTR and average position, date comparisons, and the queries that bring visitors to a page. The server description also lists sitemap data and URL inspection.
Node.js 20 or newer and access to Google Search Console are required. OAuth setup uses a Google Cloud project, the Search Console API, a Client ID, and a Client secret; service-account login instead requires a JSON key file and site access for that account. Without valid Google credentials, the server cannot authenticate.
What it helps with
- inspect clicks, impressions, CTR, and search position
- compare Search Console metrics across date ranges
- find queries that lead visitors to a page
- check site access and inspect URL indexing
Example prompts for the agent
- Compare search metrics for my site across two date ranges and report the largest changes.
- Which search queries bring visitors to
/pricing? - Check whether the URLs on my site are indexed.
How to install google-gsc-mcp
Platform CLI
claude mcp add --env WSP_CLIENT_ID=<WSP_CLIENT_ID> --env WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> --env WSP_OAUTH_FILE=<WSP_OAUTH_FILE> --env WSP_SERVICE_ACCOUNT_FILE=<WSP_SERVICE_ACCOUNT_FILE> --env WSP_ALLOW_WRITES=<WSP_ALLOW_WRITES> --transport stdio google-gsc-mcp -- npx -y google-gsc-mcpReplace <…> with your own values
Platform CLI
codex mcp add google-gsc-mcp --env WSP_CLIENT_ID=<WSP_CLIENT_ID> --env WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> --env WSP_OAUTH_FILE=<WSP_OAUTH_FILE> --env WSP_SERVICE_ACCOUNT_FILE=<WSP_SERVICE_ACCOUNT_FILE> --env WSP_ALLOW_WRITES=<WSP_ALLOW_WRITES> -- npx -y google-gsc-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"google-gsc-mcp": {
"command": "npx",
"args": [
"-y",
"google-gsc-mcp"
],
"env": {
"WSP_CLIENT_ID": "<WSP_CLIENT_ID>",
"WSP_CLIENT_SECRET": "<WSP_CLIENT_SECRET>",
"WSP_OAUTH_FILE": "<WSP_OAUTH_FILE>",
"WSP_SERVICE_ACCOUNT_FILE": "<WSP_SERVICE_ACCOUNT_FILE>",
"WSP_ALLOW_WRITES": "<WSP_ALLOW_WRITES>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"google-gsc-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-gsc-mcp"
],
"env": {
"WSP_CLIENT_ID": "<WSP_CLIENT_ID>",
"WSP_CLIENT_SECRET": "<WSP_CLIENT_SECRET>",
"WSP_OAUTH_FILE": "<WSP_OAUTH_FILE>",
"WSP_SERVICE_ACCOUNT_FILE": "<WSP_SERVICE_ACCOUNT_FILE>",
"WSP_ALLOW_WRITES": "<WSP_ALLOW_WRITES>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e WSP_CLIENT_ID=<WSP_CLIENT_ID> -e WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> -e WSP_OAUTH_FILE=<WSP_OAUTH_FILE> -e WSP_SERVICE_ACCOUNT_FILE=<WSP_SERVICE_ACCOUNT_FILE> -e WSP_ALLOW_WRITES=<WSP_ALLOW_WRITES> google-gsc-mcp npx -y google-gsc-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about google-gsc-mcp
How do I install google-gsc-mcp in Claude Code?
Run claude mcp add google-gsc-mcp -e WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> -- npx -y google-gsc-mcp. Then configure Google sign-in and restart Claude Code.
What does google-gsc-mcp do?
It connects an MCP client to Google Search Console. Its tools expose search metrics, date comparisons, page queries, sitemap data, and URL inspection.
What does google-gsc-mcp require?
It requires Node.js 20 or newer, Google Search Console access, and configured authentication. OAuth uses the Search Console API, a Google Cloud project, a Client ID, and a Client secret; the alternative is a service account with a JSON key file.