Google Search Console MCP Server

This project provides a Model Context Protocol (MCP) server that allows Claude AI (via the Claude Desktop app) or others to interact with the Google Search Console API. You can use it to query performance data, inspect URLs, check indexing status, and more, directly from your Claude chat (or others).

You can follow me on X @metehan777 and visit my blog https://metehan.ai

Features

Based on the available Google Search Console API endpoints allowed in this project:

• Sites: List accessible sites/properties in your Search Console account.
• Search Analytics: Fetch search performance data (clicks, impressions, CTR, position) with various filters and dimensions.
• URL Inspection: Inspect the status of a specific URL in the Google index, check its indexing status, and request indexing.
• Sitemaps: List submitted sitemaps for a site.
• (Helper) Get an overall site performance summary (derived from Search Analytics data).

(Note: Index coverage details and crawl errors beyond what’s available in the URL Inspection API are generally not exposed via the Google Search Console API.)

See the Search Console API capabilities & announcements here: https://developers.google.com/webmaster-tools/v1/api_reference_index

Prerequisites

• Python: Version 3.11 or higher.
• pip: Python package installer (usually comes with Python).
• Virtual Environment Tool: venv (recommended, built into Python 3).
• Google Account: With access to the Google Search Console properties you want to query.
• Claude Desktop App: Installed and running.

Setup Instructions

1. Clone or Download: Get the project files onto your local machine. If using git:

   git clone https://github.com/metehan777/google-search-console-mcp.git
   cd search-console-mcp
   

2. Create and Activate Virtual Environment: It’s highly recommended to use a virtual environment to manage dependencies.

   # Create the virtual environment (using the name 'fresh_env' as in previous steps)
   python3 -m venv fresh_env
   
   # Activate the environment
   # On macOS/Linux:
   source fresh_env/bin/activate
   # On Windows:
   # .\fresh_env\Scripts\activate
   

   (You should see (fresh_env) at the beginning of your terminal prompt)

3. Install Dependencies: Install the required Python packages, including the project itself in editable mode.

   pip install -e .
   

4. Google Cloud Setup & Credentials:

   • Enable API: Go to the Google Cloud Console and create a new project or select an existing one. Enable the “Google Search Console API” for your project.
   • Create OAuth Credentials:
     • Navigate to “APIs & Services” -> “Credentials”.