Skip to content
MCP server

Google Search Console MCP

MCP server for the Google Search Console API: search analytics, sitemaps, URL…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.3.2
Listing updated
4 days ago

About Google Search Console MCP

Google Search Console MCP is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

MCP server for the Google Search Console API: search analytics, sitemaps, URL inspection, sites.

Install

Run in a terminal

claude mcp add mcp-google-search-console --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET='<GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET>' --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN='<GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN>' --env GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN='<GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN>' -- npx -y mcp-google-search-console

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-search-console"
      ],
      "env": {
        "GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET": "<GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET>",
        "GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN": "<GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN>",
        "GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN": "<GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-search-console"
      ],
      "env": {
        "GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET": "<GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET>",
        "GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN": "<GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN>",
        "GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN": "<GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-google-search-console": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-search-console"
      ],
      "env": {
        "GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET": "<GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET>",
        "GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN": "<GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN>",
        "GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN": "<GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-search-console"
      ],
      "env": {
        "GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET": "<GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET>",
        "GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN": "<GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN>",
        "GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN": "<GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-search-console"
      ],
      "env": {
        "GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET": "<GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET>",
        "GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN": "<GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN>",
        "GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN": "<GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_SEARCH_CONSOLE_CLIENT_IDGoogle OAuth2 client id (refresh-token flow).
  • GOOGLE_SEARCH_CONSOLE_CLIENT_SECRETGoogle OAuth2 client secret (refresh-token flow). Treat it as a secret.
  • GOOGLE_SEARCH_CONSOLE_REFRESH_TOKENGoogle OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.
  • GOOGLE_SEARCH_CONSOLE_ACCESS_TOKENStatic OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, mostly for testing.
  • GOOGLE_SEARCH_CONSOLE_OAUTH_PORTFixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.
  • GOOGLE_SEARCH_CONSOLE_API_BASEAPI root override.
  • GOOGLE_SEARCH_CONSOLE_TIMEOUT_MSPer-request timeout in milliseconds.
  • GOOGLE_SEARCH_CONSOLE_MAX_RETRIESRetries on transient errors (429 always; 5xx/network for reads).

Pricing

Open source

Google Search Console MCP FAQ

Is Google Search Console MCP free?

Yes. Google Search Console MCP is open source, so you can use and self-host it for free.

How do I add Google Search Console MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-google-search-console --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET='<GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET>' --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN='<GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN>' --env GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN='<GOOGLE_SEARCH_CONSOLE_ACCESS_TOKEN>' -- npx -y mcp-google-search-console

What are the best alternatives to Google Search Console MCP?

The closest alternatives to Google Search Console MCP are Scrapling MCP Server, Firecrawl MCP Server, Google Ads + Meta Ads + SEO/GEO MCP, SearXNG Search and Calven.

Alternatives to Google Search Console MCP

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping