Google Search Console MCP Server

# Google Search Console MCP Server [](https://smithery.ai/server/mcp-server-gsc) 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](https://smithery.ai/server/mcp-server-gsc): ```bash npx -y @smithery/cli install mcp-server-gsc --client claude ``` ### Manual Installation ```bash npm install mcp-server-gsc ``` ## Authentication Setup To obtain Google Search Console API credentials: 1. Visit the [Google Cloud Console](https://console.cloud.google.com/) 2. Create a new project or select an existing one 3. Enable the API: - Go to "APIs & Services" > "Library" - Search for and enable ["Search Console API"](https://console.cloud.google.com/marketplace/product/google/searchconsole.googleapis.com) 4. Create credentials: - Navigate to ["APIs & Services" > "Credentials"](https://console.cloud.google.com/apis/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 5. Grant access: - Open Search Console - Add the service account email (format: name@project.iam.gserviceaccount.com) as a property administrator ## Usage ### Claude Desktop Configuration ```json { "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: ```json { "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.