Google Search Console MCP Server for Cursor: Setup & Config

What you can do with Google Search Console in Cursor

Authenticated Search Console reporting and indexing checks, with optional property and sitemap management.

• Compare search traffic between reporting periods.
• Review sitemap errors and submit sitemaps.
• Filter performance by device or country.

Before you start: Google Search Console in Cursor

• uv / uvx
• Google project with Search Console API enabled
• OAuth desktop client credentials or a service-account key
• Access to the relevant Search Console property

Replace /FULL/PATH/TO/uvx with the actual executable path. This example uses OAuth and opens a browser on first use. Service-account setup instead uses GSC_CREDENTIALS_PATH and GSC_SKIP_OAUTH. The source-install path needs Python 3.11+.

Google Search Console Cursor configuration

1. Choose Cursor configuration scope

   For Google Search Console MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add Google Search Console MCP Server to Cursor

   Use the mcp-gsc entry below in mcpServers. Keep Google Search Console MCP Server's documented stdio connection fields and your other Cursor entries.

3. Check Google Search Console MCP Server in Cursor

   Google Search Console MCP Server: Enable in Cursor’s MCP settings; inspect tools.

{
  "mcpServers": {
    "mcp-gsc": {
      "command": "/FULL/PATH/TO/uvx",
      "args": [
        "mcp-search-console"
      ],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "<Absolute path to downloaded desktop OAuth client JSON>"
      }
    }
  }
}

Google Search Console tools available to Cursor

Google Search Console's stored tool list documents 15 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

get_capabilities

Find get_capabilities under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

List available tools and report authentication status.

list_properties

Find list_properties under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_site_details

Find get_site_details under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_search_analytics

Find get_search_analytics under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_performance_overview

Find get_performance_overview under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

compare_search_periods

Find compare_search_periods under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_search_by_page_query

Find get_search_by_page_query under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_advanced_search_analytics

Find get_advanced_search_analytics under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

inspect_url_enhanced

Find inspect_url_enhanced under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect detailed indexing and crawl status for a URL.

batch_url_inspection

Find batch_url_inspection under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect up to ten URLs in one request.

check_indexing_issues

Find check_indexing_issues under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Check several URLs for indexing problems.

get_sitemaps

Find get_sitemaps under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

List sitemaps for a property.

list_sitemaps_enhanced

Find list_sitemaps_enhanced under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Retrieve sitemap details including errors and warnings.

manage_sitemaps

Find manage_sitemaps under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Submit or delete a sitemap, subject to configuration.

reauthenticate

Find reauthenticate under Google Search Console in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Restart browser OAuth login to authenticate again or switch accounts.

Google Search Console: full stored tool descriptions

Troubleshooting Google Search Console in Cursor

• Cursor must find uvx mcp-search-console (from uv, for Python tools) for Google Search Console MCP Server. Enable the project/user entry in MCP settings and inspect its tools.
• Review GSC_OAUTH_CLIENT_SECRETS_FILE for Google Search Console MCP Server before sharing project .cursor/mcp.json; project scope travels with the repository.
• Google Search Console MCP Server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires Google API credential setup and property access.
• Known limitation: Batch URL inspection is limited to ten URLs per call.
• Known limitation: Finalized data has a documented reporting lag.
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions