# MCP Gsc (MCP server)

> MCP Gsc is an MCP server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and any other MCP-compatible client. It has 1,863 GitHub stars, is released under the MIT license and runs locally with uvx mcp-search-console.

A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and any other MCP-compatible client.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/AminForou/mcp-gsc |
| GitHub stars | 1,863 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: mcp-search-console |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | none |
| Last commit | Sep 15, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-gsc": {
      "command": "uvx",
      "args": [
        "mcp-search-console"
      ],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "your-value",
        "GSC_CREDENTIALS_PATH": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=your-value --env GSC_CREDENTIALS_PATH=your-value --transport stdio mcp-gsc -- uvx mcp-search-console
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-gsc": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-search-console"
      ],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "your-value",
        "GSC_CREDENTIALS_PATH": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "gsc_oauth_client_secrets_file",
      "description": "GSC_OAUTH_CLIENT_SECRETS_FILE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "gsc_credentials_path",
      "description": "GSC_CREDENTIALS_PATH",
      "password": true
    }
  ],
  "servers": {
    "mcp-gsc": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-search-console"
      ],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "${input:gsc_oauth_client_secrets_file}",
        "GSC_CREDENTIALS_PATH": "${input:gsc_credentials_path}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `GSC_OAUTH_CLIENT_SECRETS_FILE` (secret): Shown in the README's example configuration.
- `GSC_CREDENTIALS_PATH` (secret): Shown in the README's example configuration.
- `GSC_SKIP_OAUTH`: Shown in the README's example configuration.

## Tools

- `get_capabilities`: Lists all tools and shows auth status — call this first if unsure
- `list_properties`: Shows all your GSC properties
- `get_site_details`: Details about a specific site
- `get_search_analytics`: Top queries and pages with clicks, impressions, CTR, position
- `get_performance_overview`: Summary of site performance
- `compare_search_periods`: Compare performance between two time periods
- `get_search_by_page_query`: Search terms driving traffic to a specific page
- `get_advanced_search_analytics`: Analytics with filters by country, device, query, page
- `inspect_url_enhanced`: Detailed crawl/index status for a URL
- `batch_url_inspection`: Inspect up to 10 URLs at once
- `check_indexing_issues`: Check multiple URLs for indexing problems
- `get_sitemaps`: Lists all sitemaps for a site
- `list_sitemaps_enhanced`: Detailed sitemap info including errors and warnings
- `manage_sitemaps`: Submit or delete sitemaps
- `reauthenticate`: Re-run the OAuth browser login (switch accounts)

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/mcp-gsc
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.