Google Search Console MCP Server

by seotesting-com

9 309 downloads Not rated yet

GitHub

About

# Google Search Console MCP Server ## 🚀 Introduction: Setting Up MCP Server In this tutorial, we’ll walk you through the process of setting up your own MCP [Model Context Protocol](https://modelcontextprotocol.io/introduction) server, adding it to Claude Desktop, and integrating it with Google Search Console (GSC)…

Explore

- Lists all verified sites in your Google Search Console account
- Queries search analytics with dimensions (query, page, device, country, date)
- Compares two time periods for SEO performance changes
- Identifies top performing pages by clicks, impressions, CTR, or position
- Provides search trend data grouped by day, week, or month

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Google Search Console MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

From the repository

Before you begin working with the project, ensure that you have the necessary tools installed. Follow these steps to check if everything is ready.

Check if Python is installed on your system by running the following command:

pip is the package manager for Python. To check if it's installed, run the following command:

uv is a Python package and project manager. To check if it's installed, run the following command:

If Claude Desktop is not installed, follow the official installation guide 🔗 Download Claude Desktop .

Check if Git is installed on your system by running the following command:

- Download the ZIP file:

bash

Add the path to your JSON credentials file and run the following command:

mcp install server.py -v GOOGLE_APPLICATION_CREDENTIALS=<path to credentials file>

Make sure you replace <path to credentials file> with the path to your JSON credentials file eg. C:\Users\Me\Downloads\credentials.json .

- "List all my verified sites in Google Search Console"
- "Show me search analytics for example.com from January 1 to January 31, 2025"
- "Compare search performance for example.com between last month and the previous month"
- "What are my top 10 pages by clicks for the last 30 days?"
- "Show me search trends by week for the last 3 months"

Go to File => Settings and click on the Developer tab. When you click on Search Console Analytics, it should display a status of 'running'. If not, there may be an error message providing details of what is causing the connection issue. If you cannot see the Settings as pictured below, make sure you have an up-to-date version of Claude Desktop: 🔗 Download Claude Desktop.

Click on Edit Config and open 'claude_desktop_config.json' in a text editor. It should contain:

{
  "mcpServers": {
    "Search Console Analytics": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth",
        "--with",
        "mcp[cli]",
        "--with",
        "pandas",
        "mcp",
        "run",
        "C:\\Documents\\gsc-mcp-server\\server.py"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "C:\\Users\\Path\\To\\Credentials\\gscaccess-credentials.json"
      }
    }
  }
}

If it contains something else, paste this data into file and make sure you update the file paths for the server.py file and the credentials file. Make sure to escape backslash characters (as shown). Restart Claude.

Open Claude Desktop and go to File > Settings > Developer.
Click "Search Console Analytics", then select Edit Config.
Locate the "command": "uv" entry in claude_desktop_config.json.
Replace "uv" with the full path to uv, which is usually: /Users/YOURUSERPROFILENAME/.local/bin/uv

Run this command to get the installation path of uv:

which -a uv

This command will display all the paths to the installations of uv you have. If the only path you can see is /Library/Frameworks/Python.framework/Versions/3.**/bin/uv , you need to 🔗 Download uv and go back to Part 3.

Save the file and restart Claude Desktop.

If the above method does not work, uv may not be installed correctly. Try installing it using Homebrew:

brew install uv

If you're still having issues, retrace your steps and ensure everything is set up correctly. 🚀

Before you begin working with the project, ensure that you have the necessary tools installed. Follow these steps to check if everything is ready.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google search console mcp server": {
            "gsc-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "gsc-mcp-server": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

🚀 Introduction: Setting Up MCP Server

In this tutorial, we’ll walk you through the process of setting up your own MCP Model Context Protocol server, adding it to Claude Desktop, and integrating it with Google Search Console (GSC) data. This will allow you to compare time periods to identify SEO improvements, generate visual reports like bar charts and line graphs, and uncover optimization opportunities by analyzing click-through rates, impressions, and ranking shifts.

Let’s get started! 🚀

🔹 What We'll Cover:

1. Generate Google Cloud Credentials – Create and download a service account JSON key to authenticate API access. 2. Install Required Tools – Ensure Python, pip, uv, and Git (optional) are installed on your system. 3. Set Up the MCP Server – Clone the repository, configure your environment, and install the MCP server. 4. Enable Search Console Insights – Verify that the MCP server is running correctly in Claude Desktop and start using advanced search analytics tools.

By the end of this guide, Claude will automatically connect to the MCP server and you'll be able to run queries, visualize data, and optimize your website’s search performance with ease. Let's get started! 🚀

🔹 What You Need to Know

This tutorial is designed to be beginner-friendly, and you don’t need any advanced technical skills. However, you should be comfortable running commands in the command line (also known as the terminal or command prompt).

Throughout this guide, you'll enter commands like:

python --version
git clone <repository-url>

If you’ve never used the command line before, don’t worry! Just follow the instructions step by step, and you'll be good to go.

That’s all you need— let’s get started! 🚀
---

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🚀 Introduction: Setting Up MCP Server

🔹 What We'll Cover:

🔹 What You Need to Know

More like this

Brave Search

🔎 GPT Researcher

Github SSE

AWS MCP Servers