GSC MCP Server

Google Search Console MCP Server — a TypeScript Model Context Protocol server that provides tools for interacting with the Google Search Console API through AI assistants like Claude Desktop.

This is a TypeScript port of the mcp-gsc Python server, fully compatible with the MCP specification.

Features

• 19 MCP Tools covering all aspects of Google Search Console

• Service Account authentication — no browser OAuth flow required

• Cross-platform — Windows, macOS, Linux

• STDIO transport support

• Zero-config defaults — automatically picks up the service account JSON from the key folder

• Safety-first — destructive operations disabled by default

Related MCP server: gsc-mcp

Tools Overview

Prerequisites

• Node.js 18+ (LTS recommended)

• A Google Cloud project with the Search Console API enabled

• A service account with access to your GSC properties (see below)

Installation

# Clone the repository
git clone <repo-url> gsc-mcp
cd gsc-mcp

# Install dependencies
npm install

# Build
npm run build

Authentication Setup

This server uses Service Account authentication only.

1. Create a service account in your Google Cloud project

2. Download the JSON key file

3. Add the service account email as a user in GSC for each property

Place the key file in the key folder of the project (the server will automatically pick the first JSON file there), or set the environment variable:

# Windows (PowerShell)
$env:GSC_CREDENTIALS_PATH = "C:\path\to\service_account_credentials.json"

# macOS / Linux
export GSC_CREDENTIALS_PATH="/path/to/service_account_credentials.json"

Credential lookup priority:

1. GSC_CREDENTIALS_PATH environment variable (absolute path)

2. The first JSON file in the key folder (default)

3. service_account_credentials.json in the script directory / current directory

Claude Desktop Configuration

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": [
        "C:\\path\\to\\gsc-mcp\\build\\index.js"
      ],
      "env": {}
    }
  }
}

If you are not using the key folder, set GSC_CREDENTIALS_PATH in env:

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["C:\\path\\to\\gsc-mcp\\build\\index.js"],
      "env": {
        "GSC_CREDENTIALS_PATH": "C:\\path\\to\\service_account_credentials.json"
      }
    }
  }
}

For macOS/Linux, use forward slashes and the export-style environment configuration.

Restart Claude Desktop after saving. You should see the hammer icon in the input box.

Environment Variables

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run (STDIO)
npm start

Project Structure

gsc-mcp/
├── src/
│   ├── index.ts    # MCP server entry point + all tool registrations
│   └── auth.ts     # Service account authentication
├── key/            # Default location for service account credentials JSON
├── build/          # Compiled JavaScript output
├── package.json
└── tsconfig.json

Credits

Original Python MCP-GSC server created by Amin Foroutan.

License

ISC