{"_id":"google-gsc-mcp","_rev":"4-3c58bcf551a4fb4fd797e8b1f851de40","name":"google-gsc-mcp","dist-tags":{"latest":"0.6.2"},"versions":{"0.0.0-stage":{"name":"google-gsc-mcp","version":"0.0.0-stage","_id":"google-gsc-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"}],"dist":{"shasum":"323927b94c0c28e5e152100c3beda11b5ed1740c","tarball":"https://registry.npmjs.org/google-gsc-mcp/-/google-gsc-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-5w/9yx2be4BeWn9IJhE9bYaBRoJ7H96QycskCV+VVvK0FwwKd37yF9DTRR7/41heuQPOjT7zv76C99RTOxD9yw==","signatures":[{"sig":"MEUCIH24BbyFUK9ejJFoBhXtzbM6TNsRGbfsAFnrje6NwTi5AiEAiyhnjpcleqLSiH3V82PqAsNa1C+boQXt0MmAnanawM0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":336},"_npmUser":{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.6.0":{"name":"google-gsc-mcp","version":"0.6.0","keywords":["mcp","mcp-server","google search console mcp","google-search-console","gsc mcp","search console mcp server","seo","claude","search analytics"],"author":{"name":"Bilal Naseer"},"license":"MIT","_id":"google-gsc-mcp@0.6.0","maintainers":[{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"}],"homepage":"https://github.com/bilalnaseer/google-search-console-mcp","bugs":{"url":"https://github.com/bilalnaseer/google-search-console-mcp/issues"},"bin":{"google-search-console-mcp":"dist/index.js"},"dist":{"shasum":"fcbf57585c52a69bb6392c94eb62747b455ccaa2","tarball":"https://registry.npmjs.org/google-gsc-mcp/-/google-gsc-mcp-0.6.0.tgz","fileCount":13,"integrity":"sha512-yG2bnOnJ60Wm3mNPGCqGgjRXt8F9DqLDsOi1S0cuzxoJAAnP34jVhEdKzF12L+m+Q1yhJWNbmSF6jyaB2NAK2Q==","signatures":[{"sig":"MEUCIQDcNzySWmfoZycpjgSHD6m9dNZJYjTjeEizFnAT+z34RQIgC57YpgjrlxD6nn+slG+d3rxrD1cIJVB39qTHI4VaobA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIH5MTP4WZtVbCPXNp99Hg+Dw63QL1ARB5C51uYbH00bBAiBVxqINIdoQtVXHoJT/5mrMuG3uxuQLnmEOAuikW2hdoA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":122590},"type":"module","engines":{"node":">=20"},"gitHead":"711fcfa372843afa749bf9b7257fbb1418280485","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"},"repository":{"url":"git+https://github.com/bilalnaseer/google-search-console-mcp.git","type":"git"},"_npmVersion":"11.19.1","description":"Google Search Console MCP server for Claude, Cursor and any MCP client. Query search analytics, sitemaps and URL inspection.","directories":{},"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.6.7","open":"^11.0.4","googleapis":"^189.0.0","google-auth-library":"^11.3.2","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","vitest":"^5.0.5","typescript":"^7.0.2","@types/node":"^26.6.6"},"_npmOperationalInternal":{"tmp":"tmp/google-gsc-mcp_0.6.0_1793876990662_0.44796385947661865","host":"s3://npm-registry-packages-npm-production"}},"0.6.1":{"name":"google-gsc-mcp","version":"0.6.1","keywords":["mcp","mcp-server","google search console mcp","google-search-console","gsc mcp","search console mcp server","seo","claude","search analytics"],"author":{"name":"Bilal Naseer"},"license":"MIT","_id":"google-gsc-mcp@0.6.1","maintainers":[{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"}],"homepage":"https://github.com/bilalnaseer/google-search-console-mcp","bugs":{"url":"https://github.com/bilalnaseer/google-search-console-mcp/issues"},"bin":{"google-search-console-mcp":"dist/index.js"},"dist":{"shasum":"6e81500f76ad203e2c02e84824e29a7a2d723a82","tarball":"https://registry.npmjs.org/google-gsc-mcp/-/google-gsc-mcp-0.6.1.tgz","fileCount":13,"integrity":"sha512-O80i2W7J+6MooC191DrmMU7RjfSsQ2ebK0UnVQ9rE5HQeCVBKJDkNAR9Xz5qiyfaR42qXdDcz+Uo6tw6/isF3Q==","signatures":[{"sig":"MEUCIAZTV0EIP0Rn+ncuVuUwKObzGFoJXlzVIkbLttPySZrDAiEAm9u5QpZLNsA8IfvD9qXqLVxVJVeAsoCXK94rMK+wM9c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBlm3D/RJmbdnavtinnlrfdwmkyAFTwY9l8JzcH4Tr6nAiA847EZ8oVNzWMyjXUhHu0M0dMZcmRkCwQsTaK3lAysjw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121281},"type":"module","engines":{"node":">=20"},"gitHead":"23993665a90ee6d95772ba0d7d97380d76be115d","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"},"repository":{"url":"git+https://github.com/bilalnaseer/google-search-console-mcp.git","type":"git"},"_npmVersion":"11.19.1","description":"Google Search Console MCP server for Claude, Cursor and any MCP client. Query search analytics, sitemaps and URL inspection.","directories":{},"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.6.7","open":"^11.0.4","googleapis":"^189.0.0","google-auth-library":"^11.3.2","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","vitest":"^5.0.5","typescript":"^7.0.2","@types/node":"^26.6.6"},"_npmOperationalInternal":{"tmp":"tmp/google-gsc-mcp_0.6.1_1793880090567_0.051779652086396455","host":"s3://npm-registry-packages-npm-production"}},"0.6.2":{"_id":"google-gsc-mcp@0.6.2","bin":{"google-search-console-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/bilalnaseer/google-search-console-mcp/issues"},"dist":{"shasum":"9c1726cb4cac47e7782e2f830ca9cd3084f69636","tarball":"https://registry.npmjs.org/google-gsc-mcp/-/google-gsc-mcp-0.6.2.tgz","fileCount":13,"integrity":"sha512-Fur7/ApUgSfQYbl7iE0vNJQF2nTHk79mHyJsRNWys5nfBFfoezkFqQAs2LgdQ4VoK/EnZR++4hIdMJPZwqZWOQ==","signatures":[{"sig":"MEQCIFaul3PdBJC1iKCDBmZgtxvfsQDzMj6wUVPp+115n+z9AiAirK1+0XftiiJNkrJ7MJub66dO7eIjSSyngdzcKmi/4Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCmtKWa89bNMJz7zSNAxltGIf8oXhIvTipBcwjIf0gWjgIhAMIp0hFOOSNun5aiRSw/3uwDsxAeN1WTEkQa1uzJ1MYz"}],"unpackedSize":121653},"name":"google-gsc-mcp","type":"module","author":{"name":"Bilal Naseer"},"engines":{"node":">=20"},"gitHead":"f38797482fd291a7be6a68aaf6a9014233485d23","license":"MIT","mcpName":"io.github.bilalnaseer/google-gsc-mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"version":"0.6.2","_npmUser":{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"},"homepage":"https://github.com/bilalnaseer/google-search-console-mcp","keywords":["mcp","mcp-server","google search console mcp","google-search-console","gsc mcp","search console mcp server","seo","claude","search analytics"],"repository":{"url":"git+https://github.com/bilalnaseer/google-search-console-mcp.git","type":"git"},"_npmVersion":"11.19.1","description":"Google Search Console MCP server for Claude, Cursor and any MCP client. Query search analytics, sitemaps and URL inspection.","directories":{},"maintainers":[{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.6.7","open":"^11.0.4","googleapis":"^189.0.0","google-auth-library":"^11.3.2","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","vitest":"^5.0.5","typescript":"^7.0.2","@types/node":"^26.6.6"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-gsc-mcp_0.6.2_1794825995216_0.23137304284113913"}}},"time":{"created":"2026-11-05T11:05:41.561Z","modified":"2026-11-16T10:46:35.472Z","0.0.0-stage":"2026-11-05T11:05:41.561Z","0.6.0":"2026-11-05T11:09:50.749Z","0.6.1":"2026-11-05T12:01:30.678Z","0.6.2":"2026-11-16T10:46:35.313Z"},"bugs":{"url":"https://github.com/bilalnaseer/google-search-console-mcp/issues"},"author":{"name":"Bilal Naseer"},"license":"MIT","homepage":"https://github.com/bilalnaseer/google-search-console-mcp","keywords":["mcp","mcp-server","google search console mcp","google-search-console","gsc mcp","search console mcp server","seo","claude","search analytics"],"repository":{"url":"git+https://github.com/bilalnaseer/google-search-console-mcp.git","type":"git"},"description":"Google Search Console MCP server for Claude, Cursor and any MCP client. Query search analytics, sitemaps and URL inspection.","maintainers":[{"name":"bilalnaseer","email":"bilalnaseer01@gmail.com"}],"readme":"# Google Search Console MCP Server\n\n[![npm version](https://img.shields.io/npm/v/google-gsc-mcp)](https://www.npmjs.com/package/google-gsc-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/google-gsc-mcp)](https://www.npmjs.com/package/google-gsc-mcp)\n[![license](https://img.shields.io/github/license/bilalnaseer/google-search-console-mcp)](LICENSE)\n\nTalk to your [Google Search Console](https://search.google.com/search-console/about) data in plain English from Claude, Cursor, Codex, Gemini CLI or any other MCP app.\n\n> *\"Which keywords lost clicks this month?\"*\n> *\"Are my top 10 pages indexed?\"*\n> *\"Compare January with February and tell me what changed.\"*\n\n**Jump to:** [Setup](#setup) · [Tools](#tools) · [Settings](#settings) · [Example prompts](#example-prompts) · [Troubleshooting](#troubleshooting) · [Docker & remote](#docker--remote)\n\n---\n\n## Setup\n\nYou need [Node.js](https://nodejs.org/) 20 or newer (`node --version` to check). Setup takes about 3 minutes and you only do it once.\n\n### 1. Create a Client ID and Secret\n\n1. Open [Google Cloud Console](https://console.cloud.google.com/), then create a project (or pick one).\n2. [Enable the Search Console API](https://console.cloud.google.com/apis/library/searchconsole.googleapis.com).\n3. Open **Google Auth Platform** and set up the consent screen: enter an app name and your email, and choose **External** as the audience.\n4. Under **Audience → Test users**, click **+ Add users** and add the Google account that has access to your Search Console sites. While the app is in *Testing*, only these accounts can sign in.\n5. Go to **Clients → Create client**, set **Application type** to **Desktop app**, and click **Create**.\n6. Copy the **Client ID** and **Client secret**. The secret can't be shown again after you close the dialog.\n\nThis project doesn't ship a login of its own, so your data never goes through anyone else's Google project.\n\n### 2. Add this to your app's MCP config\n\n```json\n{\n  \"mcpServers\": {\n    \"search-console\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"google-gsc-mcp\"],\n      \"env\": {\n        \"WSP_CLIENT_ID\": \"your-client-id.apps.googleusercontent.com\",\n        \"WSP_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n| App | Config file |\n|---|---|\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Claude Desktop (Windows) | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Claude Code | `claude mcp add search-console -e WSP_CLIENT_ID=... -e WSP_CLIENT_SECRET=... -- npx -y google-gsc-mcp` |\n| Cursor | `~/.cursor/mcp.json` |\n| Gemini CLI, Antigravity, others | Your app's MCP config file |\n\n<details>\n<summary><strong>Codex CLI</strong> uses TOML instead</summary>\n\nFile: `~/.codex/config.toml`\n\n```toml\n[mcp_servers.search-console]\ncommand = \"npx\"\nargs = [\"-y\", \"google-gsc-mcp\"]\nenabled = true\nenv = { WSP_CLIENT_ID = \"your-client-id.apps.googleusercontent.com\", WSP_CLIENT_SECRET = \"your-client-secret\" }\n```\n\n</details>\n\n### 3. Restart and sign in\n\n**Fully quit** your app and reopen it (on macOS press `Cmd+Q`; closing the window isn't enough). Then ask: *\"List my Search Console websites.\"*\n\nThe first time, a browser window opens so you can sign in to Google. Pick the account you added as a test user. If Google warns that the app isn't verified, click **Advanced → Go to (your app name)**. After that you stay signed in.\n\nIf something goes wrong, ask *\"Run wsp_show_status_gsc\"*. It shows whether you're signed in and the exact error.\n\n### Other ways to sign in\n\n<details>\n<summary><strong>Service account</strong> (automation and teams)</summary>\n\n1. In [Credentials](https://console.cloud.google.com/apis/credentials), choose **Create Credentials → Service Account**.\n2. Open the **Keys** tab → **Add Key → Create new key → JSON**, and download it to a safe place.\n3. In Search Console, open **Settings → Users and permissions → Add user**, paste the service account's email and give it **Full** access.\n4. Use this `env` block instead:\n\n```json\n\"env\": {\n  \"WSP_SERVICE_ACCOUNT_FILE\": \"/full/path/to/service_account.json\",\n  \"WSP_SERVICE_ACCOUNT_ONLY\": \"true\"\n}\n```\n\nWith neither a client nor a service account set, the server falls back to [Google's default credentials](https://cloud.google.com/docs/authentication/application-default-credentials) (`gcloud auth application-default login`, Cloud Run, GKE, Workload Identity Federation).\n\n</details>\n\n<details>\n<summary><strong>Use a downloaded JSON file</strong> instead of Client ID and Secret</summary>\n\nClick **Download JSON** when you create the client, save it somewhere safe, and set `WSP_OAUTH_FILE` to its full path, e.g. `\"WSP_OAUTH_FILE\": \"/Users/you/secrets/client_secrets.json\"`. It is ignored if `WSP_CLIENT_ID` and `WSP_CLIENT_SECRET` are set.\n\n</details>\n\n<details>\n<summary><strong>Multiple Google accounts</strong></summary>\n\nAdd one MCP entry per account, each with its own `WSP_TOKEN_DIR`, so the saved logins don't overwrite each other. All entries can share the same Client ID and secret. Add every account as a test user.\n\n```json\n\"search-console-work\": {\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"google-gsc-mcp\"],\n  \"env\": {\n    \"WSP_CLIENT_ID\": \"...\",\n    \"WSP_CLIENT_SECRET\": \"...\",\n    \"WSP_TOKEN_DIR\": \"/Users/you/.gsc-tokens/work\"\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>Run from source</strong> instead of npx</summary>\n\n```bash\ngit clone https://github.com/bilalnaseer/google-search-console-mcp.git\ncd google-search-console-mcp\nnpm install\nnpm run build\n```\n\nThen use `\"command\": \"node\"` and `\"args\": [\"/full/path/to/google-search-console-mcp/dist/index.js\"]` in your config.\n\n</details>\n\n---\n\n## Tools\n\nMost tools need a `site_url`. Get it from `wsp_list_websites_gsc` and copy it exactly. It looks like `https://example.com/` or `sc-domain:example.com`.\n\n| Tool | What it does |\n|---|---|\n| **Getting started** | |\n| `wsp_show_status_gsc` | Shows whether you're signed in and lists every tool |\n| `wsp_list_websites_gsc` | Lists your Search Console websites and their exact `site_url` |\n| `wsp_show_website_gsc` | Your permission level and verification details for one website |\n| `wsp_login_again_gsc` | Opens the Google login again, e.g. to switch accounts or fix login errors |\n| **Traffic & keywords** | |\n| `wsp_show_traffic_gsc` | Clicks, impressions, CTR and position: totals plus a daily trend |\n| `wsp_compare_dates_gsc` | Compares two date ranges and shows what went up or down most |\n| `wsp_find_page_keywords_gsc` | The search keywords that bring visitors to one page |\n| `wsp_run_report_gsc` | Custom report with filters, sorting, device, country, search type, up to 25,000 rows |\n| **Indexing** | |\n| `wsp_check_url_gsc` | Is this page indexed? Last crawl, canonical, robots and rich results |\n| `wsp_check_urls_gsc` | The same check for up to 10 pages at once |\n| **Sitemaps** | |\n| `wsp_show_sitemaps_gsc` | All your sitemaps with status, errors and warnings |\n| `wsp_show_sitemap_gsc` | Full details for one sitemap |\n| **Write tools** (off by default) | |\n| `wsp_add_sitemap_gsc` | Submits or resubmits a sitemap |\n| `wsp_remove_sitemap_gsc` | Removes a sitemap (pages already indexed stay indexed) |\n| `wsp_add_website_gsc` | Adds a website to Search Console |\n| `wsp_remove_website_gsc` | Removes a website from Search Console |\n\n### Turning on write tools\n\nBy default the server only **reads** your data. To let it add or remove websites and sitemaps:\n\n1. Add `\"WSP_ALLOW_WRITES\": \"true\"` to your `env` block.\n2. Restart your app.\n3. Ask it to run `wsp_login_again_gsc` once so Google grants the extra permission.\n\n---\n\n## Settings\n\nPut these in the `env` block of your config.\n\n| Setting | Default | What it does |\n|---|---|---|\n| `WSP_CLIENT_ID` | — | OAuth Client ID |\n| `WSP_CLIENT_SECRET` | — | OAuth Client secret (use together with `WSP_CLIENT_ID`) |\n| `WSP_OAUTH_FILE` | — | Alternative to the two above: full path to your OAuth `client_secrets.json`. Ignored if ID and secret are set |\n| `WSP_SERVICE_ACCOUNT_FILE` | — | Full path to your service account key |\n| `WSP_SERVICE_ACCOUNT_ONLY` | `false` | `true` skips the Google login and uses only the service account |\n| `WSP_DATA_MODE` | `all` | `all` matches the Search Console dashboard. `final` shows only confirmed data (2–3 days behind) |\n| `WSP_ALLOW_WRITES` | `false` | `true` turns on the write tools. Run `wsp_login_again_gsc` after changing it |\n| `WSP_TOKEN_DIR` | OS config folder | Where your saved login (`token.json`) is kept. Rarely needed |\n\nThe server tries logins in this order: saved Google login → service account → Google default credentials.\n\n---\n\n## Example prompts\n\n| Goal | Ask |\n|---|---|\n| See your sites | \"List my Search Console websites.\" |\n| Fix low CTR | \"Show my top 20 keywords for mysite.com in the last 30 days. Flag any with CTR under 2% and suggest better titles.\" |\n| Spot drops | \"Show traffic for mysite.com over the last 28 days and explain any sudden drops or spikes.\" |\n| Month vs month | \"Compare January with February. Which keywords improved most?\" |\n| Check indexing | \"Are these pages indexed? mysite.com/product, mysite.com/services, mysite.com/about\" |\n| Audit one page | \"Check mysite.com/landing-page and give me a list of fixes.\" |\n| Quick wins | \"Find keywords with lots of impressions but position 11–20, mobile and US only.\" |\n\n---\n\n## Troubleshooting\n\n**Start here:** ask your app to *\"run wsp_show_status_gsc\"*. It shows the exact login status and error.\n\n<details>\n<summary><strong><code>spawn npx ENOENT</code> or <code>command not found: npx</code></strong></summary>\n\nYour app can't find `npx`. This is common with nvm or fnm. Find the full path:\n\n```bash\nwhich npx     # macOS / Linux\nwhere npx     # Windows\n```\n\nThen use that path as `\"command\"`, e.g. `\"/Users/you/.nvm/versions/node/v22.0.0/bin/npx\"`.\n\n</details>\n\n<details>\n<summary><strong>Login failed or file not found</strong></summary>\n\n- File paths must be **full paths**. `~/` works, but a bare file name doesn't.\n- Check `WSP_CLIENT_ID` and `WSP_CLIENT_SECRET` for typos or extra spaces.\n- If you set `WSP_OAUTH_FILE` or `WSP_SERVICE_ACCOUNT_FILE`, the file must exist. The server stops and names the setting if it can't find it.\n- Seeing `invalid_grant` or want another Google account? Run `wsp_login_again_gsc`.\n- Changed `WSP_ALLOW_WRITES`? Run `wsp_login_again_gsc`.\n\n</details>\n\n<details>\n<summary><strong>\"Access blocked\" or <code>Error 403: access_denied</code> when signing in</strong></summary>\n\nYour OAuth app is in *Testing* mode and the Google account you picked isn't a test user. Open **Google Auth Platform → Audience → Test users**, click **+ Add users**, add that account, then run `wsp_login_again_gsc` again. Having access to the Cloud project is not enough; the account must be on this list.\n\n</details>\n\n<details>\n<summary><strong>\"No Search Console properties found\"</strong></summary>\n\nYou signed in, but that Google account has no Search Console access. Run `wsp_login_again_gsc` and pick the account that owns or is a user on your sites, and make sure it is also a test user (see above).\n\n</details>\n\n<details>\n<summary><strong>\"Property not found (404)\"</strong></summary>\n\n- Copy `site_url` exactly from `wsp_list_websites_gsc`.\n- Domain properties look like `sc-domain:example.com`, not a full URL.\n- A service account must be added as a user on that website in Search Console.\n\n</details>\n\n<details>\n<summary><strong>Works in Claude Desktop but not on claude.ai</strong></summary>\n\nThe server runs on your computer, so it only works in the [Claude Desktop app](https://claude.ai/download), not in the browser.\n\n</details>\n\n<details>\n<summary><strong>Config changes do nothing</strong></summary>\n\nFully quit the app (`Cmd+Q`) and reopen it. Also check that your JSON is valid and every path is a full path.\n\n</details>\n\n---\n\n## Docker & remote\n\nSkip this unless you want to run the server on another machine or in a container.\n\n| Setting | Default | What it does |\n|---|---|---|\n| `WSP_TRANSPORT` | `stdio` | Set to `sse` to serve over the network |\n| `WSP_HOST` | `127.0.0.1` | Address to listen on |\n| `WSP_PORT` | `3001` | Port to listen on |\n\n```bash\nWSP_TRANSPORT=sse WSP_HOST=0.0.0.0 WSP_PORT=3001 node dist/index.js\n```\n\nApps connect to `http://HOST:3001/sse`.\n\n> The SSE endpoint has no password. Don't expose it to the internet without a reverse proxy or firewall in front.\n\n**Docker:**\n\n```bash\ndocker build -t google-search-console-mcp .\n\ndocker run \\\n  -e WSP_TRANSPORT=sse \\\n  -e WSP_HOST=0.0.0.0 \\\n  -e WSP_PORT=3001 \\\n  -e WSP_SERVICE_ACCOUNT_FILE=/app/credentials.json \\\n  -e WSP_SERVICE_ACCOUNT_ONLY=true \\\n  -v /path/to/credentials.json:/app/credentials.json \\\n  -p 3001:3001 \\\n  google-search-console-mcp\n```\n\nA container can't open a browser, so use a service account, or mount a `token.json` you already signed in with and point `WSP_TOKEN_DIR` at its folder.\n\n---\n\n## Development\n\n```bash\nnpm install\nnpm test            # no Google login needed\nnpm run typecheck\nnpm run dev         # run from source\n```\n\nBugs and ideas are welcome as GitHub issues or pull requests.\n\n## License\n\nMIT, see [LICENSE](LICENSE). Maintained by [Bilal Naseer](https://github.com/bilalnaseer).\n","readmeFilename":"README.md"}