search-console-mcp — Claude Code MCP server: setup
Connects Google Search Console to an MCP client for read-only search data and SEO analysis in chat. Use it to inspect traffic, indexing, and search queries.
claude mcp add search-console-mcp -- npx -y search-console-mcp-serverWhat search-console-mcp does
search-console-mcp runs locally with Node and connects Google Search Console to Claude Code, Codex, Cursor, and other MCP clients. After Google sign-in, the server can read properties, queries, clicks, impressions, CTR, positions, URL indexing status, and sitemaps.
It includes period comparisons and ten prepared SEO analyses covering traffic drops, cannibalization, internal links, indexing, and query opportunities. The server is read-only by design: the webmasters.readonly scope cannot change properties, submit sitemaps, or perform write operations.
You need npx and access to Google Search Console. A Google Cloud project and API keys are not required; tokens stay on the local machine under ~/.search-console-mcp/. Google sign-in is required before the server can read Search Console data.
What it helps with
- spot pages that lost clicks
- compare queries, impressions, and rankings
- check whether a URL is indexed
- find competing pages for one query
- plan internal links from existing data
Example prompts for the agent
- Show me the pages that lost the most clicks this month compared with the previous month.
- Find queries ranked from positions 8 to 15 with real impressions and rank the closest page-one opportunities.
- Check whether
https://mysite.com/pricingis indexed and explain the reason if it is not.
How to install search-console-mcp
Platform CLI
claude mcp add search-console-mcp -- npx -y search-console-mcp-serverPlatform CLI
codex mcp add sudomichael-search-console-mcp -- npx -y search-console-mcp-serverConfig file
{
"mcpServers": {
"sudomichael-search-console-mcp": {
"command": "npx",
"args": [
"-y",
"search-console-mcp-server"
]
}
}
}Config file
{
"servers": {
"sudomichael-search-console-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"search-console-mcp-server"
]
}
}
}Platform CLI
gemini mcp add sudomichael-search-console-mcp npx -y search-console-mcp-serverStep 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 search-console-mcp
How do I install search-console-mcp in Claude Code?
Run npx search-console-mcp-server login and complete Google sign-in. Then add the server with claude mcp add search-console-mcp -- npx -y search-console-mcp-server.
What does search-console-mcp do?
It gives an MCP client read access to Google Search Console data, including queries, pages, traffic, indexing, and sitemaps. Its built-in analyses cover traffic loss, cannibalization, internal links, and growth opportunities.
Do I need a Google Cloud project or an API key?
No. Sign in with Google once; the token is stored locally under ~/.search-console-mcp/, and the server uses the webmasters.readonly scope.
