Which integrations are available for this server?

Provides read-only access to Google Search Console data, allowing users to query site performance metrics including keywords, clicks, impressions, CTR, rankings, and sitemap status.

How do I use searchconsole-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@searchconsole-mcp What are my top 10 keywords by clicks this month?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

searchconsole-mcp

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

Tool	Description
`list_sites`	Lists all verified Search Console properties with permission levels
`query_search_analytics`	Query keyword/page data — clicks, impressions, CTR, average position. Supports filtering by dimension, date range, search type, and pagination
`list_sitemaps`	Lists submitted sitemaps for a property

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

Add to ~/.claude.json:

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

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Any MCP-compatible client can connect over stdio. Run the server with:

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