Required environment variables (set in Cursor MCP settings after install)

| Variable | Required | Description | |---|---|---| | GSC_OAUTH_CLIENT_SECRETS_FILE | One of these two | Path to your OAuth client_secrets.json | | GSC_CREDENTIALS_PATH | One of these two | Path to your service account credentials JSON | | GSC_DATA_STATE | Optional | all (default, matches GSC dashboard) or final (2–3 day lag) | | GSC_ALLOW_DESTRUCTIVE | Optional | Set to true to enable add/delete site and delete sitemap tools |

First-time authentication (OAuth users only)

After installing, ask your AI assistant: "Authenticate my Google Search Console" — it will run the reauthenticate tool which opens a browser window once to authorize access. Subsequent uses are token-based and require no interaction.

What Can This Tool Do For SEO Professionals?

1. Property Management

   • See all your GSC properties in one place
   • Get verification details and basic site information
   • Add new properties to your account
   • Remove properties from your account

2. Search Analytics & Reporting

   • Discover which search queries bring visitors to your site
   • Track impressions, clicks, and click-through rates
   • Analyze performance trends over time
   • Compare different time periods to spot changes
   • Visualize your data with charts and graphs created by Claude

3. URL Inspection & Indexing

   • Check if specific pages have indexing problems
   • See when Google last crawled your pages
   • Inspect multiple URLs at once to identify patterns
   • Get actionable insights on how to improve indexing

4. Sitemap Management

   • View all your sitemaps and their status
   • Submit new sitemaps directly through Claude
   • Check for errors or warnings in your sitemaps
   • Monitor sitemap processing status

Available Tools

Here's what you can ask your AI assistant to do once you've set up this integration:

| What You Can Ask For | What It Does | What You'll Need to Provide | |---------------------------------|-------------------------------------------------------------|----------------------------------------------------------------| | list_properties | Shows all your GSC properties | Nothing - just ask! | | get_site_details | Shows details about a specific site | Your website URL | | add_site | Adds a new site to your GSC properties | Your website URL | | delete_site | Removes a site from your GSC properties | Your website URL | | get_search_analytics | Shows top queries and pages with metrics | Your website URL, time period, and optional row_limit (default 20, max 500) | | get_performance_overview | Gives a summary of site performance | Your website URL and time period | | check_indexing_issues | Checks if pages have indexing problems | Your website URL and list of pages to check | | inspect_url_enhanced | Detailed inspection of a specific URL | Your website URL and the page to inspect | | get_sitemaps | Lists all sitemaps for your site | Your website URL | | submit_sitemap | Submits a new sitemap to Google | Your website URL and sitemap URL |

For a complete list of all 20 available tools and their detailed descriptions, ask your AI assistant to "list tools" after setup.

Getting Started (No Coding Experience Required!)

1. Set Up Google Search Console API Access

Before using this tool, you'll need to create API credentials that allow your AI assistant to access your GSC data:

Authentication Options

The tool supports two authentication methods:

1. OAuth Authentication (Recommended)

This method allows you to authenticate with your own Google account, which is often more convenient than using a service account. It will have access to the same resources you normally do.

Set GSC_SKIP_OAUTH to "true", "1", or "yes" to skip OAuth authentication and use only service account authentication

Setup Instructions:

1. Go to the Google Cloud Console and create a Google Cloud account if you don't have one
2. Create a new project or select an existing one
3. Enable the Search Console API for your project
4. Add scope https://www.googleapis.com/auth/webmasters to your project
5. Go to the "Credentials" page
6. Click "Create Credentials" and select "OAuth client ID"
7. Configure the OAuth consent screen
8. For application type, select "Desktop app"
9. Give your OAuth client a name and click "Create"
10. Download the client secrets JSON file (it will be named something like client_secrets.json)
11. Place this file in the same directory as the script or set the GSC_OAUTH_CLIENT_SECRETS_FILE environment variable to point to its location

When you run the tool for the first time with OAuth authentication, it will open a browser window asking you to sign in to your Google account and authorize the application. After authorization, the tool will save the token for future use.

2. Service Account Authentication

This method uses a service account, which is useful for automated scripts or when you don't want to use your personal Google account. This requires adding the service account as a user in Google Search Console.

Setup Instructions:

1. Go to the Google Cloud Console and create a Google Cloud account if you don't have one
2. Create a new project or select an existing one
3. Enable the Search Console API for your project
4. Go to the "Credentials" page
5. Click "Create Credentials" and select "Service Account"
6. Fill in the service account details and click "Create"
7. Click on the newly created service account
8. Go to the "Keys" tab and click "Add Key" > "Create new key"
9. Select JSON format and click "Create"
10. Download the key file and save it as service_account_credentials.json in the same directory as the script or set the GSC_CREDENTIALS_PATH environment variable to point to its location
11. Add your service account email address to appropriate Search Console properties

🎬 Watch this beginner-friendly tutorial on Youtube:

Click the image above to watch the step-by-step video tutorial

2. Install Required Software

You'll need to install these tools on your computer:

• Python (version 3.11 or newer) - This runs the MCP server
• An MCP-compatible AI client — Claude Desktop, Cursor, Codex CLI, Gemini CLI, or Antigravity are all supported

Make sure Python is properly installed and available in your system path before proceeding.

3. Install the MCP Server

Option A — uvx (simplest, no clone needed)

If you have [uv](https://docs.astral.sh/uv/