Google Search Console MCP Server

By ahonn GitHub

A Model Context Protocol (MCP) server providing access to Google Search Console

Overview

What is Google Search Console MCP Server?

Google Search Console MCP Server is a Model Context Protocol (MCP) server that provides access to Google Search Console, enabling users to retrieve search analytics data and perform rich data analysis.

How to use Google Search Console MCP Server?

To use the server, install it via Smithery or manually using npm, and set up authentication with Google Cloud Project credentials. Configure the server in your application to start retrieving data.

Key features of Google Search Console MCP Server?

Search analytics data retrieval with dimensions support
Customizable reporting periods for rich data analysis

Use cases of Google Search Console MCP Server?

Analyzing website search performance over specific periods.
Custom reporting based on various dimensions like queries and devices.
Integrating search data into applications for enhanced insights.

FAQ from Google Search Console MCP Server?

What are the prerequisites for using this server?

You need Node.js 18 or later, a Google Cloud Project with Search Console API enabled, and Service Account credentials with Search Console access.

Is there a manual installation option?

Yes, you can install it manually using npm with the command npm install mcp-server-gsc.

How do I set up authentication?

Follow the steps in the documentation to create a Google Cloud Project, enable the Search Console API, and create Service Account credentials.

Content

Google Search Console MCP Server

A Model Context Protocol (MCP) server providing access to Google Search Console.

Features

Search analytics data retrieval with dimensions support
Rich data analysis with customizable reporting periods

Prerequisites

Node.js 18 or later
Google Cloud Project with Search Console API enabled
Service Account credentials with Search Console access

Installation

Installing via Smithery

To install Google Search Console for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-server-gsc --client claude

Manual Installation

npm install mcp-server-gsc

Authentication Setup

To obtain Google Search Console API credentials:

Visit the Google Cloud Console
Create a new project or select an existing one
Enable the API:

Go to "APIs & Services" > "Library"
Search for and enable "Search Console API"

Create credentials:

Navigate to "APIs & Services" > "Credentials"
Click "Create Credentials" > "Service Account"
Fill in the service account details
Create a new key in JSON format
The credentials file (.json) will download automatically

Grant access:

Open Search Console
Add the service account email (format: name@project.iam.gserviceaccount.com) as a property administrator

Usage

Claude Desktop Configuration

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

Available Tools

search_analytics

Get search performance data from Google Search Console with customizable parameters:

Required Parameters:

siteUrl: Site URL (format: http://www.example.com/ or sc-domain:example.com)
startDate: Start date (YYYY-MM-DD)
endDate: End date (YYYY-MM-DD)

Optional Parameters:

dimensions: Comma-separated list (query,page,country,device,searchAppearance)
type: Search type (web, image, video, news)
aggregationType: Aggregation method (auto, byNewsShowcasePanel, byProperty, byPage)
rowLimit: Maximum rows to return (default: 1000)

Example:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

License

MIT

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting pull requests.

No tools information available.

No content found.