{"_id":"mcp-server-google-search-console","_rev":"3-efbd48f04415edb9ee703e27c94b14c7","name":"mcp-server-google-search-console","dist-tags":{"latest":"1.0.1"},"versions":{"0.1.0":{"name":"mcp-server-google-search-console","version":"0.1.0","keywords":["mcp","model-context-protocol","google-search-console","gsc","seo","search-analytics","url-inspection","sitemap","webmaster-tools"],"author":{"url":"https://github.com/thein-art","name":"Tobias Hein"},"license":"MIT","_id":"mcp-server-google-search-console@0.1.0","maintainers":[{"name":"thein-art","email":"t.hein@artaxo.com"}],"homepage":"https://github.com/thein-art/mcp-server-google-search-console#readme","bugs":{"url":"https://github.com/thein-art/mcp-server-google-search-console/issues"},"bin":{"mcp-server-google-search-console":"dist/index.js"},"dist":{"shasum":"aeea596588c09e4fba56be531aab31aa57517a6e","tarball":"https://registry.npmjs.org/mcp-server-google-search-console/-/mcp-server-google-search-console-0.1.0.tgz","fileCount":51,"integrity":"sha512-PFhQQy2rE06HNQ0Pr+B1hwh2AdShOYBYRuJr1Me2zYczGKpZVnsRZG5IDntDvG13qYdDhPKVIkbhATDYDH2rKw==","signatures":[{"sig":"MEQCIBvtgWJgPtoz5ut5iRzSvLurmVCTOSHwvjqyfNzL+NVWAiA1WtYhFGp2JTD3wsD1/F4Y2sD7SrndhqQK+TYM1W110A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":183347},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"1a489a47fb48557b502c1707999093421eb72bdd","mcpName":"io.github.thein-art/google-search-console","scripts":{"dev":"tsc --watch","test":"vitest","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"thein-art","email":"t.hein@artaxo.com"},"repository":{"url":"git+https://github.com/thein-art/mcp-server-google-search-console.git","type":"git"},"_npmVersion":"11.9.0","description":"Community-built MCP server for Google Search Console API","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.7.0","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-google-search-console_0.1.0_1772963474751_0.4689702977524808","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"mcp-server-google-search-console","version":"1.0.0","keywords":["mcp","model-context-protocol","google-search-console","gsc","seo","search-analytics","url-inspection","sitemap","webmaster-tools"],"author":{"url":"https://github.com/thein-art","name":"Tobias Hein"},"license":"MIT","_id":"mcp-server-google-search-console@1.0.0","maintainers":[{"name":"thein-art","email":"t.hein@artaxo.com"}],"homepage":"https://github.com/thein-art/mcp-server-google-search-console#readme","bugs":{"url":"https://github.com/thein-art/mcp-server-google-search-console/issues"},"bin":{"mcp-server-google-search-console":"dist/index.js"},"dist":{"shasum":"2e682933e26d0345e0c298afd3e8580cc6044f59","tarball":"https://registry.npmjs.org/mcp-server-google-search-console/-/mcp-server-google-search-console-1.0.0.tgz","fileCount":51,"integrity":"sha512-TWaAWCVUmyeIU+k9msBASc0Zab3akjGQ56Ny1uaSlC0kqett5JAxfEqhgonywuTgWBFgttmoV6FhhrM51ruZ/g==","signatures":[{"sig":"MEYCIQDsD0k5urSyu6/RWms/KpI3tljU2nrZMrWkmI041zE/1AIhAOg93EOeyLyTuw+SRSb+dgeKq2a3EgmBdt4pON62fH3G","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-server-google-search-console@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":201250},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"0295c72497a96d3529703263e1a39f7cfcf892bd","mcpName":"io.github.thein-art/google-search-console","scripts":{"dev":"tsc --watch","test":"vitest","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:dd30972e-7ffd-4719-a485-b26c6466ac24"}},"repository":{"url":"git+https://github.com/thein-art/mcp-server-google-search-console.git","type":"git"},"_npmVersion":"11.11.0","description":"Community-built MCP server for Google Search Console API","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.7.0","@types/node":"^25.3.5","semantic-release":"^25.0.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-google-search-console_1.0.0_1773092580657_0.4824471665980685","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"mcp-server-google-search-console","version":"1.0.1","description":"Community-built MCP server for Google Search Console API","type":"module","bin":{"mcp-server-google-search-console":"dist/index.js"},"engines":{"node":">=22.0.0"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","test":"vitest","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","zod":"^4.3.6"},"devDependencies":{"@types/node":"^25.3.5","semantic-release":"^25.0.3","typescript":"^5.7.0","vitest":"^4.0.18"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"license":"MIT","author":{"name":"Tobias Hein","url":"https://github.com/thein-art"},"repository":{"type":"git","url":"git+https://github.com/thein-art/mcp-server-google-search-console.git"},"homepage":"https://github.com/thein-art/mcp-server-google-search-console#readme","bugs":{"url":"https://github.com/thein-art/mcp-server-google-search-console/issues"},"keywords":["mcp","model-context-protocol","google-search-console","gsc","seo","search-analytics","url-inspection","sitemap","webmaster-tools"],"mcpName":"io.github.thein-art/google-search-console","gitHead":"f831de88ce4ca0a0bf25e26779de940585e5f675","_id":"mcp-server-google-search-console@1.0.1","_nodeVersion":"22.22.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-mvlzZB5AqrP2g9j53xpBukBLFjYR+JstBbW5NnmEDWj+d17zxIpkiMtehNLQjMQry1WN7448PWt9U0Tug3WyjQ==","shasum":"c2f1a55651890df8e30c8a47450a39c94db4216f","tarball":"https://registry.npmjs.org/mcp-server-google-search-console/-/mcp-server-google-search-console-1.0.1.tgz","fileCount":51,"unpackedSize":201250,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-server-google-search-console@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCpKrNdlJF7z+Nmrgc8sZKR8mWKtaIPgwoijobExN8EQAIgdxc09jUn0z8+paUbcqBRKNHJpLDBHPDTso7PEBbGT34="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:dd30972e-7ffd-4719-a485-b26c6466ac24"}},"directories":{},"maintainers":[{"name":"thein-art","email":"t.hein@artaxo.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-google-search-console_1.0.1_1773093980325_0.8648667603949474"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-08T09:51:14.749Z","modified":"2026-03-09T22:06:20.929Z","0.1.0":"2026-03-08T09:51:14.893Z","1.0.0":"2026-03-09T21:43:00.814Z","1.0.1":"2026-03-09T22:06:20.516Z"},"bugs":{"url":"https://github.com/thein-art/mcp-server-google-search-console/issues"},"author":{"name":"Tobias Hein","url":"https://github.com/thein-art"},"license":"MIT","homepage":"https://github.com/thein-art/mcp-server-google-search-console#readme","keywords":["mcp","model-context-protocol","google-search-console","gsc","seo","search-analytics","url-inspection","sitemap","webmaster-tools"],"repository":{"type":"git","url":"git+https://github.com/thein-art/mcp-server-google-search-console.git"},"description":"Community-built MCP server for Google Search Console API","maintainers":[{"name":"thein-art","email":"t.hein@artaxo.com"}],"readme":"# mcp-server-google-search-console\n\n[![CI](https://img.shields.io/github/actions/workflow/status/thein-art/mcp-server-google-search-console/ci.yml?branch=master&style=flat-square&label=CI)](https://github.com/thein-art/mcp-server-google-search-console/actions/workflows/ci.yml)\n[![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)\n[![MCP compatible](https://img.shields.io/badge/MCP-compatible-0098FF?style=flat-square)](https://modelcontextprotocol.io/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)\n[![npm version](https://img.shields.io/npm/v/mcp-server-google-search-console?style=flat-square)](https://www.npmjs.com/package/mcp-server-google-search-console)\n[![npm downloads](https://img.shields.io/npm/dm/mcp-server-google-search-console?style=flat-square)](https://www.npmjs.com/package/mcp-server-google-search-console)\n\nCommunity-built MCP server for the Google Search Console API. Provides search analytics, performance summaries, URL inspection, sitemap management, and property listing through the [Model Context Protocol](https://modelcontextprotocol.io/).\n\n## Features\n\n- **9 tools** covering search analytics, performance summaries, URL inspection, sitemap management, and property listing\n- **3 prompts** for guided multi-step SEO workflows\n- **2 resources** for automatic property and sitemap discovery\n- **Service Account & OAuth** — choose headless or interactive authentication\n- **Read-only by default** — write tools are only registered when write scope is configured\n- **Safety gates** — `delete_sitemap` requires explicit `confirm: true`\n- **Minimal dependencies** — only `@modelcontextprotocol/sdk` and `zod`\n\n## Quick Start\n\n### 1. Set Up Credentials\n\n**Service Account (recommended for servers & CI):**\n\n1. Go to [Google Cloud Console](https://console.cloud.google.com/)\n2. Create or select a project\n3. Enable the **Google Search Console API**\n4. Create a **Service Account** and download the JSON key file\n5. In [Google Search Console](https://search.google.com/search-console), add the service account email as a user to your properties\n\n**OAuth (recommended for personal use):**\n\n1. In Google Cloud Console, create **OAuth 2.0 Client ID** (type: Desktop app)\n2. Download the client credentials JSON\n3. Set `GSC_OAUTH_CLIENT_FILE` — the server will open a browser for consent on first run\n4. Tokens are cached at `~/.config/gsc-mcp/oauth-token.json` (or `GSC_OAUTH_TOKEN_FILE`)\n\n### 2. Configure Your Client\n\n<details open>\n<summary><strong>Claude Code</strong></summary>\n\n```bash\nclaude mcp add google-search-console \\\n  -e GSC_SERVICE_ACCOUNT_KEY_FILE=/path/to/service-account-key.json \\\n  -- npx -y mcp-server-google-search-console\n```\n\nOr add to `.mcp.json` manually:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-search-console\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-server-google-search-console\"],\n      \"env\": {\n        \"GSC_SERVICE_ACCOUNT_KEY_FILE\": \"/path/to/service-account-key.json\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-search-console\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-server-google-search-console\"],\n      \"env\": {\n        \"GSC_SERVICE_ACCOUNT_KEY_FILE\": \"/path/to/service-account-key.json\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Cursor</strong></summary>\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-search-console\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-server-google-search-console\"],\n      \"env\": {\n        \"GSC_SERVICE_ACCOUNT_KEY_FILE\": \"/path/to/service-account-key.json\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>VS Code / Copilot</strong></summary>\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"google-search-console\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-server-google-search-console\"],\n      \"env\": {\n        \"GSC_SERVICE_ACCOUNT_KEY_FILE\": \"/path/to/service-account-key.json\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Docker</strong></summary>\n\n```bash\ndocker build -t gsc-mcp .\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"google-search-console\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"--rm\", \"-i\",\n        \"-e\", \"GSC_SERVICE_ACCOUNT_KEY_FILE=/key.json\",\n        \"-v\", \"/path/to/service-account-key.json:/key.json:ro\",\n        \"gsc-mcp\"\n      ]\n    }\n  }\n}\n```\n</details>\n\n## Tools\n\n### Always available (read-only scope)\n\n| Tool | Description |\n|------|-------------|\n| `list_sites` | List all GSC properties accessible by the current credentials |\n| `get_site` | Get details for a specific property (permission level, verification) |\n| `get_search_analytics` | Query search performance data with dimensions, filters, date ranges, and comparison mode |\n| `get_performance_summary` | Quick performance overview: current vs previous period metrics, deltas, and top 10 queries in a single call |\n| `inspect_url` | Check a URL's indexing status, mobile usability, and rich results |\n| `batch_inspect_urls` | Inspect multiple URLs concurrently (up to 20) with a single call |\n| `list_sitemaps` | List all sitemaps for a property with aggregated health summary |\n\n### Write scope required\n\nThese tools are only registered when `GSC_SCOPES` includes the full write scope. They do not appear in the tool list otherwise.\n\n| Tool | Description |\n|------|-------------|\n| `submit_sitemap` | Submit a sitemap to Google |\n| `delete_sitemap` | Delete a sitemap (requires `confirm: true` safety gate) |\n\n## Prompts\n\nGuided multi-step SEO workflows that guide LLMs through structured analysis.\n\n| Prompt | Parameters | Description |\n|--------|------------|-------------|\n| `seo_performance_analysis` | `site_url`, `period` (7d/28d/90d) | 5-step analysis: Top Queries → Top Pages → Device Split → Country Split → Trends. Produces a structured report with actionable insights. |\n| `index_coverage_check` | `site_url`, `urls` (comma-separated) | Batch URL inspection with structured coverage report — flags indexing issues, canonical mismatches, and mobile problems. |\n| `content_opportunity_analysis` | `site_url` | Full-funnel analysis: Low-Hanging Fruit (positions 5–20), Keyword Cannibalization detection, and Trending queries via comparison mode. |\n\n## Resources\n\n| URI | Description |\n|-----|-------------|\n| `sites://list` | Auto-discovery of all GSC properties accessible with current credentials. Enables LLMs to discover available sites without calling `list_sites` first. |\n| `sitemaps://{site_url}` | Sitemaps for a specific property (e.g. `sitemaps://sc-domain:example.com`) with health summary, errors, warnings, and index rates. |\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `GSC_SERVICE_ACCOUNT_KEY_FILE` | * | Path to service account JSON key file |\n| `GSC_SERVICE_ACCOUNT_KEY` | * | Inline service account JSON (alternative to file) |\n| `GSC_OAUTH_CLIENT_FILE` | * | Path to OAuth client credentials JSON (Desktop app type) |\n| `GSC_OAUTH_TOKEN_FILE` | No | Custom path for cached OAuth tokens (default: `~/.config/gsc-mcp/oauth-token.json`) |\n| `GSC_SCOPES` | No | OAuth scope. Default: `webmasters.readonly`. Set to `https://www.googleapis.com/auth/webmasters` for write access |\n\n\\* **Auth priority:** OAuth (`GSC_OAUTH_CLIENT_FILE`) > Service Account (`GSC_SERVICE_ACCOUNT_KEY_FILE` or `GSC_SERVICE_ACCOUNT_KEY`). At least one must be configured.\n\n## Development\n\n```bash\nnpm install      # Install dependencies\nnpm run build    # Build\nnpm run dev      # Watch mode\nnpm test         # Run tests\n```\n\n## License\n\n[MIT](LICENSE)\n\n> **Note:** This is an unofficial community project. It is not affiliated with or endorsed by Google.\n\n---\n\nBuilt by [Tobias Hein](https://github.com/thein-art) at [artaxo](https://artaxo.com) — a digital marketing agency specializing in AI Search Optimization.\n","readmeFilename":"README.md"}