Google Search Console · onlymoein — Claude Code MCP server: install guide
Local MCP server for Google Search Console data. Inspect indexing status, sitemaps, clicks, and ranking shifts directly through AI chat.
claude mcp add --env GSC_SERVICE_ACCOUNT_FILE=<GSC_SERVICE_ACCOUNT_FILE> --env GSC_ENABLE_WRITES=<GSC_ENABLE_WRITES> --transport stdio onlymoein-google-search-console -- uvx open-gsc-mcpWhat Google Search Console does
This server connects coding agents to the Google Search Console API. It retrieves metrics for clicks, impressions, positions, and CTR across dimensions like device, query, and country. Built-in tools like explain_change isolate traffic fluctuations and match them against official Google updates.
API pitfalls are caught locally. The server checks invalid regex patterns, bad country codes, and future ranges before querying Google, preventing silent empty responses. If you do not mark your OAuth setup as In production inside Google Cloud, your login token will expire after 7 days.
Running the tool requires uv and an authenticated Google Cloud project. Modification tools support adding properties and sitemaps, but you can turn off mutation requests using GSC_ENABLE_WRITES=0.
What it helps with
- pull query impressions and click-through rates by country
- pinpoint queries with traffic drops after core updates
- verify URL indexing status across sitemap files
- submit updated XML sitemaps to Search Console
Example prompts for the agent
- Audit the indexing status for all pages in our sitemap.
- Show hourly impressions and click counts for the past three days.
How to install Google Search Console
Platform CLI
claude mcp add --env GSC_SERVICE_ACCOUNT_FILE=<GSC_SERVICE_ACCOUNT_FILE> --env GSC_ENABLE_WRITES=<GSC_ENABLE_WRITES> --transport stdio onlymoein-google-search-console -- uvx open-gsc-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from open-gsc-mcp <command>
Platform CLI
codex mcp add onlymoein-google-search-console --env GSC_SERVICE_ACCOUNT_FILE=<GSC_SERVICE_ACCOUNT_FILE> --env GSC_ENABLE_WRITES=<GSC_ENABLE_WRITES> -- uvx open-gsc-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from open-gsc-mcp <command>
Config file
{
"mcpServers": {
"onlymoein-google-search-console": {
"command": "uvx",
"args": [
"open-gsc-mcp"
],
"env": {
"GSC_SERVICE_ACCOUNT_FILE": "<GSC_SERVICE_ACCOUNT_FILE>",
"GSC_ENABLE_WRITES": "<GSC_ENABLE_WRITES>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from open-gsc-mcp <command>
Config file
{
"servers": {
"onlymoein-google-search-console": {
"type": "stdio",
"command": "uvx",
"args": [
"open-gsc-mcp"
],
"env": {
"GSC_SERVICE_ACCOUNT_FILE": "<GSC_SERVICE_ACCOUNT_FILE>",
"GSC_ENABLE_WRITES": "<GSC_ENABLE_WRITES>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from open-gsc-mcp <command>
Platform CLI
gemini mcp add -e GSC_SERVICE_ACCOUNT_FILE=<GSC_SERVICE_ACCOUNT_FILE> -e GSC_ENABLE_WRITES=<GSC_ENABLE_WRITES> onlymoein-google-search-console uvx open-gsc-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from open-gsc-mcp <command>
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 Search Console
How to install Google Search Console in Claude Code?
Run claude mcp add google-search-console-mcp -- uvx open-gsc-mcp in your terminal. Ensure uv is installed on your machine before running the command.
What does the Google Search Console MCP server do?
It translates natural language prompts into Search Console API requests. Assistants receive structured output covering clicks, query positions, URL inspection, and site audits.
How do I disable write actions and deletions?
Pass GSC_ENABLE_WRITES=0 in your client environment settings or MCP configuration. This prevents the server from modifying properties or submitting sitemaps.
Similar MCP servers
Everything for SEO and GEO →Google Search Console by other authors comes first.
