Searchconsole

CI Python 3.11+ License: MIT

An MCP server that gives AI assistants read-only access to your Google Search Console data. Ask questions about your site's search performance in natural language — keywords, clicks, impressions, CTR, rankings, sitemaps, and more.

Tools

Quick Start

1. Install

git clone https://github.com/chrishart0/searchconsole-mcp.git
cd searchconsole-mcp
uv sync

2. Authenticate

This server uses Google Application Default Credentials. Choose one:

Option A — Service account key (recommended for automation):

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

Option B — User credentials (recommended for local development):

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/webmasters.readonly"

The service account or user must have access to the Search Console properties you want to query.

3. Connect to your MCP client

{
  "mcpServers": {
    "searchconsole-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/searchconsole-mcp", "searchconsole-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
      }
    }
  }
}

{
  "mcpServers": {
    "searchconsole-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/searchconsole-mcp", "searchconsole-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
      }
    }
  }
}

uv run --directory /path/to/searchconsole-mcp searchconsole-mcp

Example Prompts

Once connected, try asking your AI assistant:

• "What are my top 10 keywords by clicks this month?"
• "Show me pages with high impressions but low CTR"
• "List all my Search Console properties"
• "What queries is my site ranking for on page 2 of Google?"
• "Show me my sitemaps and their status"

Development

uv sync --dev
uv run pytest

License

MIT