All integrations

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. 1

    Install Claude Desktop

    Download Claude Desktop from claude.ai/download, open it, and sign in with your Anthropic account.

  2. 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. 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.

    shell
    node --version
  4. 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. 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. 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 integrations

Cursor

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.

5 steps · 5 min read

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.

3 steps · 3 min read

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.

4 steps · 4 min read

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.

4 steps · 4 min read

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.

5 steps · 5 min read

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.

4 steps · 5 min read

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.

3 steps · 4 min read

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.

5 steps · 5 min read

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.

4 steps · 4 min read

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.

3 steps · 3 min read

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.

4 steps · 5 min read

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.

5 steps · 5 min read

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.

5 steps · 5 min read

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.

5 steps · 4 min read

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.

5 steps · 5 min read

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.

5 steps · 6 min read

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.

5 steps · 5 min read

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.

5 steps · 5 min read

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.

5 steps · 5 min read

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.

5 steps · 5 min read

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.

5 steps · 5 min read

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.

5 steps · 5 min read

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.

5 steps · 4 min read

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.

5 steps · 5 min read

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.

6 steps · 6 min read

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.

6 steps · 6 min read

Done. Your AI client now has access to your Search Console data.

Got stuck? Email support@gscpap.com with the error and we will revise the guide.