Integration · Claude Desktop
Connect Claude Desktop to Google Search Console
6 steps · about 6 minutes
By the GSC PAP team · Updated
If you set up a self-hosted Search Console MCP server, the first step happens in the Google Cloud Console: create a project, enable the Search Console API, create OAuth credentials, download a JSON file, then keep the refresh token working. GSC PAP is a hosted MCP server, so you skip all of that. You sign in with Google, copy one token, and add one config block to Claude Desktop.
Claude Desktop is Anthropic's desktop app for macOS and Windows. It talks to GSC PAP over the Model Context Protocol (MCP), so Claude can read your clicks, impressions, CTR and average position and answer questions about them. Access is read-only.
Claude Desktop's config file only runs MCP servers it can start as a local command, so this guide connects through mcp-remote, a small open-source bridge that npx starts for you. It needs Node.js on your machine. If you would rather not install anything, see the connector option in the questions at the end.
How to connect Google Search Console to Claude Desktop
- 1
Install Claude Desktop
Download Claude Desktop from claude.ai/download, open it, and sign in with your Anthropic account.
- 2
Sign in to GSC PAP and copy your token
Visit gscpap.com and click "Sign in with Google." Grant the read-only Search Console access. The connect page shows your bearer token once, so copy it now. If you lose it, create a new one at app.gscpap.com/account/tokens; your other tokens keep working.
- 3
Check that Node.js is installed
The bridge runs through npx, which ships with Node.js. Open a terminal and run the command below. If it prints a version number you are set. If the command is not found, install the LTS version from nodejs.org, then continue.
shellnode --version - 4
Open the Claude Desktop config file
Claude Desktop keeps its MCP servers in claude_desktop_config.json. Its Open Developer Config File command opens it for you, or open it directly at the path for your OS below. If the file does not exist yet, create it.
shell# macOS ~/Library/Application Support/Claude/claude_desktop_config.json # Windows %APPDATA%\Claude\claude_desktop_config.json - 5
Add the GSC PAP server block
Paste the block below and replace YOUR_TOKEN with the token from step 2, keeping the word Bearer and the space before it. If the file already has an mcpServers section, add gsc-pap inside it next to your other servers instead of pasting a second mcpServers. Leave "Authorization:${AUTH}" exactly as written: the bridge fills in AUTH from the env block, and keeping the space out of the argument avoids a known Windows problem with spaces in arguments.
json{ "mcpServers": { "gsc-pap": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.gscpap.com/mcp", "--header", "Authorization:${AUTH}" ], "env": { "AUTH": "Bearer YOUR_TOKEN" } } } } - 6
Restart Claude Desktop and ask a question
Quit Claude Desktop completely (Cmd+Q on macOS, or Quit from the tray icon on Windows) and open it again. The first start takes a little longer while npx downloads the bridge. Open a new chat and ask: "What sites are in my Search Console?" Claude calls list_sites and lists your verified properties. From there, try "Show me my top queries last week."
Claude Desktop not showing your Search Console data?
- ·Claude Desktop says "The following entries in claude_desktop_config.json are not valid MCP server configurations": an entry has the wrong shape. A block with "url" and "headers" produces exactly this, even though Cursor and other clients use that shape. Claude Desktop's config file only accepts servers it launches as a command, with command, args and env, which is why this guide uses the mcp-remote bridge.
- ·"npx: command not found" or the server never starts: Node.js is missing or not on Claude Desktop's PATH. Install the LTS from nodejs.org and restart Claude Desktop.
- ·GSC PAP tools do not appear, or Claude reports an authorization error: the token in AUTH is wrong or was revoked. Create a new one at app.gscpap.com/account/tokens and paste it into AUTH, with Bearer and a space in front, then restart Claude Desktop.
- ·Claude Desktop reports a config error: check the JSON for trailing commas or unmatched braces. Run the file through a JSON validator if unsure.
- ·On Windows, %APPDATA% expands to C:\Users\<you>\AppData\Roaming, which File Explorer hides by default. The Open Developer Config File command avoids hunting for it.
Frequently asked questions
Do I need a Google Cloud project to connect Claude to Search Console?
No. GSC PAP calls the Search Console API through its own OAuth client, which is already registered with Google. You never open the Google Cloud Console, enable an API, create OAuth credentials, or download a JSON file. A self-hosted MCP server needs all of those steps, which typically take 30 to 45 minutes the first time.
Is it free, and do I need a paid Claude plan?
GSC PAP is free during the public preview: no credit card, no trial expiration, no feature gate. The limits are 60 tool calls per minute and 1,000 per hour per user. On the Claude side, the Free plan works with the config file setup in this guide.
Can Claude change anything in my Search Console?
No. GSC PAP requests the read-only webmasters.readonly scope. Claude can read your verified sites, search analytics, sitemap status and URL inspection results. It cannot add or remove sites, submit sitemaps, or request indexing.
Can I connect Claude Desktop without editing the config file?
Yes. Claude Desktop also supports custom connectors, which sign you in with OAuth instead of a pasted token. Add https://mcp.gscpap.com/mcp as a custom connector and approve the consent screen, as shown in the Claude.ai Connectors guide. Anthropic limits Free plans to one custom connector.
Other integrations
All integrationsCursor
Connect Google Search Console to Cursor through a hosted MCP server. Sign in with Google, paste one token into mcp.json, and skip the Google Cloud project.
Claude Code
Add Google Search Console to Claude Code with one claude mcp add command. Hosted and read-only: no Google Cloud project, no OAuth credentials, no Python.
Codex CLI (OpenAI)
Add Google Search Console, GA4 and PageSpeed data to OpenAI's Codex CLI with one TOML block and a bearer token. You never create a Google Cloud project.
VS Code (GitHub Copilot)
Connect Google Search Console to GitHub Copilot in VS Code with one .vscode/mcp.json entry, then ask agent mode about GSC. You skip Google Cloud setup.
Gemini CLI (Google)
Query Google Search Console (GSC) from your terminal with Gemini CLI. Register GSC PAP as an MCP server in settings.json, with no Google Cloud project.
Windsurf (Devin Desktop)
Give Windsurf, now Devin Desktop, your Google Search Console data. Add GSC PAP as a remote MCP server with one bearer token and no Google Cloud project.
Zed Editor
Bring Google Search Console into Zed's AI assistant as an MCP context server. You add one settings.json block and a token, with no Google Cloud setup.
JetBrains IDEs
Connect Google Search Console to IntelliJ, PyCharm, WebStorm and other JetBrains IDEs via AI Assistant's MCP settings, without a Google Cloud project.
Continue (extension)
Continue MCP setup for Google Search Console: add one mcpServers entry with a bearer token in VS Code or JetBrains. You do not need a Google Cloud project.
Claude.ai (browser)
Add Google Search Console to Claude.ai as a custom connector. Paste one URL and approve access. No token to copy, no config file, no Google Cloud project.
Direct HTTP (curl, custom agents)
Call the GSC PAP MCP server from curl or your own agent. It is JSON-RPC over HTTP with a bearer token, so you need no MCP client or Google Cloud project.
opencode
Add Google Search Console to opencode as a remote MCP server. One config block with your token, no Google Cloud project, no local server to run.
Cline
Add Google Search Console to Cline in VS Code or the Cline CLI as a remote MCP server. One token, no Google Cloud project, read-only access.
Warp
Add Google Search Console to Warp's agent as a remote MCP server. Paste one JSON block with your token, press Start, and ask about your traffic in the terminal.
LM Studio
Give a local model your Search Console data. Add GSC PAP to LM Studio's mcp.json as a remote server, with one token and no Google Cloud project.
ChatGPT
Add Google Search Console to ChatGPT as a custom MCP server. What the setup looks like, and the plan requirement that decides whether you can do it at all.
Goose
Add Google Search Console to Goose as a streamable_http extension. One block in config.yaml with your token, no Google Cloud project, read-only access.
Google Antigravity
Add Search Console to Google Antigravity as a custom MCP server. It handles dynamic client registration, so the setup is a URL and a sign-in, with no token.
Roo Code
Add Google Search Console to Roo Code in VS Code as a streamable-http MCP server. One block with your token, no Google Cloud project, read-only.
Kilo Code
Add Google Search Console to Kilo Code as a remote MCP server. It can negotiate OAuth for you, or take a bearer token. No Google Cloud project either way.
Amp
Add Google Search Console to Amp as a remote MCP server, in settings or with one CLI command. No Google Cloud project, read-only scopes.
Kiro
Add Google Search Console to Kiro as a remote MCP server. One entry in mcp.json, the token read from an approved environment variable, read-only access.
Raycast
Add Google Search Console to Raycast AI as an HTTP MCP server. Dynamic OAuth means no token to paste, and HTTP servers work on Raycast for iOS too.
GitHub Copilot CLI
Add Google Search Console to GitHub Copilot CLI with one command or one JSON entry. Remote HTTP transport, your token in a header, read-only access.
n8n
Give an n8n AI Agent your Search Console data through the MCP Client Tool node, and schedule the SEO report you keep meaning to write.
LibreChat
Add GSC PAP to librechat.yaml as a streamable-http MCP server, and give every user on your install their own Search Console access rather than a shared one.