Skip to content
MCP server

Google Search Console

Self-hosted Google Search Console MCP for analytics, URL inspection and sitemaps

Pricing
Open source
Platforms
CLI, self-hosted
Runs
Remotely
Version
0.4.41-registry.1
Listing updated
3 days ago

About Google Search Console

Google Search Console is an open-source MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

The npm launcher starts a loopback-only Streamable HTTP server on 127.0.0.1 (port 8080 by default), not a stdio process, so cloud-hosted Claude and ChatGPT cannot reach it directly. For remote access you deploy your own Cloudflare Worker.

Setup is not one-click: you create a Google Cloud OAuth client, register the exact redirect URI, and set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET and a 32-byte base64 TOKEN_ENCRYPTION_KEY. The launcher defaults to read-write, so analytics-only users should set GSC_ACCESS_MODE=readonly before signing in, which leaves write tools unregistered. Session state is encrypted under ~/.mcp-gsc/state.

It needs Node.js 22.18 or newer and is MIT licensed.

Install

Run in a terminal

claude mcp add mcp-gsc --env GOOGLE_CLIENT_ID='<GOOGLE_CLIENT_ID>' --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env TOKEN_ENCRYPTION_KEY='<TOKEN_ENCRYPTION_KEY>' -- npx -y @digestseo/mcp-gsc

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-gsc": {
      "command": "npx",
      "args": [
        "-y",
        "@digestseo/mcp-gsc"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "TOKEN_ENCRYPTION_KEY": "<TOKEN_ENCRYPTION_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-gsc": {
      "command": "npx",
      "args": [
        "-y",
        "@digestseo/mcp-gsc"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "TOKEN_ENCRYPTION_KEY": "<TOKEN_ENCRYPTION_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-gsc": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@digestseo/mcp-gsc"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "TOKEN_ENCRYPTION_KEY": "<TOKEN_ENCRYPTION_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-gsc": {
      "command": "npx",
      "args": [
        "-y",
        "@digestseo/mcp-gsc"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "TOKEN_ENCRYPTION_KEY": "<TOKEN_ENCRYPTION_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-gsc": {
      "command": "npx",
      "args": [
        "-y",
        "@digestseo/mcp-gsc"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "TOKEN_ENCRYPTION_KEY": "<TOKEN_ENCRYPTION_KEY>"
      }
    }
  }
}

Configuration

  • PORTLocal HTTP port used by the npm launcher.
  • GSC_ACCESS_MODEGoogle/Search Console access mode for the local launcher. Use readonly for least privilege or readwrite for the six mutation tools.
  • MCP_GSC_STATE_DIROptional directory for persistent local Wrangler/KV/Durable Object/OAuth state. When omitted, the npm launcher uses its stable per-user default.
  • GOOGLE_CLIENT_IDGoogle OAuth client ID for the local Worker.Required
  • GOOGLE_CLIENT_SECRETGoogle OAuth client secret for the local Worker.Required
  • TOKEN_ENCRYPTION_KEYBase64-encoded 32-byte key used to encrypt stored Google refresh tokens.Required

What it does

Search analytics
Query clicks, impressions, CTR and position.
URL inspection
Check how Google sees individual URLs.
Sitemap management
Inspect and manage sitemaps.
Read-only mode
Skips registering write tools.
Local or Worker
Run via npm locally or on Cloudflare.

Good for

  • Pull top queries for a page
  • Check indexing for a URL
  • Review sitemap status
  • Run an SEO diagnostic

Pricing

Open source

MIT licensed

Prices change. Check digestseo.com before you buy.

Google Search Console FAQ

Is it free?

The MIT-licensed software is free.

Which Node version?

^22.18.0 or >=24.11.0.

Can I use it from ChatGPT?

Only via your own HTTPS Worker or a tunnel, since localhost is unreachable.

Is Google Search Console free?

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

How do I add Google Search Console to Claude Code?

Run this command in your terminal: claude mcp add mcp-gsc --env GOOGLE_CLIENT_ID='<GOOGLE_CLIENT_ID>' --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env TOKEN_ENCRYPTION_KEY='<TOKEN_ENCRYPTION_KEY>' -- npx -y @digestseo/mcp-gsc

What are the best alternatives to Google Search Console?

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

Alternatives to Google Search Console

  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. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  4. 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
  5. 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
  6. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments