# How to connect Google Search Console to ChatGPT

Connect Google Search Console to ChatGPT with HyperGSC. Set up the connection, run your first report and fix common errors.

[Carl Brownson](/about)

On this page

## Quick answer

- Connect your Google account in HyperGSC. Your first Search Console properties connect automatically; unshare individual sites in Connections if needed.

- In ChatGPT Plugins, add a custom MCP server with https://hypergsc.com/mcp and sign in.

- Ask ChatGPT to list your connected Search Console websites. If yours appears, you are connected.

## What you need

- A Google account with access to your website in Search Console.

- A HyperGSC account.

- ChatGPT on the web, with an account and workspace that allow custom MCP servers. Your AI subscription and HyperGSC plan are separate.

## 1. Connect your website in HyperGSC

- Sign in to HyperGSC and open Settings.

- Connect the Google account that has access to your website in Search Console.

- Your first Search Console properties connect automatically on every plan. Unshare individual sites in Connections if needed.

Search Console calls each website a property. Signing in to HyperGSC with Google is separate from connecting Search Console, so complete this step even if you already signed in with Google.

- [Open HyperGSC Settings](/settings)

## 2. Add HyperGSC to ChatGPT

- Open ChatGPT Plugins, select +, then Add custom MCP server.

- Name it HyperGSC, add a short description, and enter the server URL below under Connection.

- Use OAuth authentication and finish signing in to HyperGSC.

- Review the connection warning and choose Create as a plugin.

- Install the plugin, switch from Chat to Work, and start a new Work chat. Type @ and select HyperGSC.

HyperGSC server URL

```text
https://hypergsc.com/mcp
```

## 3. Check the connection

Send this in ChatGPT:

Connection check prompt

```text
Use HyperGSC to list my connected Search Console websites.
```

The assistant should list the websites you enabled in HyperGSC. If more than one appears, choose the one you want to use.

Once that works, try your first report:

First report prompt

```text
Use HyperGSC for [my property]. Show my top 5 pages by clicks for the latest complete 7 days available. Include the property, exact dates, search type, country and device filters, clicks, impressions, CTR and average position. State any row limits or missing data. Do not invent results if a tool call fails.
```

Replace [my property] with the exact property returned by the connection check. Recent Search Console data can be delayed.

## Read your first report

ChatGPT should return data for the website you selected. Open the HyperGSC tool result to check the website, dates and filters.

Example page report

| Page | Clicks | Impressions | CTR | Average position |
| --- | --- | --- | --- | --- |
| /guides/setup | 120 | 4,000 | 3.0% | 8.2 |
| /pricing | 45 | 900 | 5.0% | 4.1 |
| /blog/checklist | 20 | 2,000 | 1.0% | 15.6 |

CTR is clicks divided by impressions. Average position shows where the page appeared in search results, averaged across searches.

If the numbers differ from Search Console, check that both reports use the same website, dates, search type, country, device and grouping. A Domain property covers all subdomains and protocols; a URL-prefix property covers only addresses starting with that prefix.

## Review your traffic each week

Weekly review prompt

```text
Use HyperGSC for [my property]. Compare the latest complete 7 days with the previous 7 days using the same filters. Show the pages with the biggest click changes, including impressions, CTR and average position. Include the dates and suggest what to check next for each page.
```

Choose a query and ask the assistant to look up its Google search results for your country and language. Starter and higher plans include search result and keyword research; Pro also compares your keywords with competitors’. Search volume and competitor traffic figures are estimates from DataForSEO.

Make the edit in your website’s CMS. On Starter or higher, you can give the assistant projects:write permission to save the URL, date and what you changed in HyperGSC. Compare traffic before and after the edit, accounting for seasonal changes and search demand.

- [Explore HyperGSC plans](/pricing)

## Report dates and limits

- Recent Search Console data can be delayed or incomplete. Use complete days for comparisons. Daily reports use Pacific Time.

- Free includes 30 days of history. Paid plans support up to 16 months where Google has data. HyperGSC sets no row cap on search analytics responses.

- Google hides some queries for privacy, so query rows can add up to less than the chart total.

- If a report is empty, check the dates, filters and selected website.

- URL inspection shows the version Google indexed. Use Search Console to test the current page or request indexing.

## If something does not work

ChatGPT connection troubleshooting

| What you see | What to check |
| --- | --- |
| No custom MCP option | Use ChatGPT on the web and check Plugins. Account access, workspace permissions and security restrictions can prevent adding custom MCP servers. |
| Connected, but no tool call | Install the custom plugin, start a new Work chat, type @ and select HyperGSC. Run the property-list prompt. |
| Property missing or access denied | In HyperGSC Settings, check the Google account has Search Console access and refresh sites. New sites connect automatically, up to 250; if you turned a site off, turn it back on under Sites. Connecting Search Console is a separate step from signing in with Google. |
| OAuth failed or authorization expired | Check that the server URL ends in /mcp, then reconnect and finish browser sign-in with your HyperGSC account. |
| No rows or different totals | Check that the dates are within your plan’s history and the filters and grouping match Search Console. |
| Tool unavailable or quota reached | Ask which reports your plan supports and how much of your allowance remains. Reconnecting does not reset quotas. |
| Cannot save a change record | Saving requires Starter or higher and projects:write permission in HyperGSC. |

## Common questions

## Sources and further reading

- [Google: Search Analytics dates, filters and row limits](https://developers.google.com/webmaster-tools/v1/searchanalytics/query)

- [Google: URL Inspection reports the indexed version](https://developers.google.com/webmaster-tools/v1/urlInspection.index/inspect)

- [OpenAI: install and use a plugin in ChatGPT Work](https://developers.openai.com/plugins/quickstart)

- [OpenAI: connect and test an MCP connection](https://developers.openai.com/plugins/deploy/connect-chatgpt)

- [HyperGSC: privacy and client access](https://hypergsc.com/privacy)

## A better Search Console for you and your agents

[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fhypergsc.com%2Fagent-setup%20and%20follow%20the%20instructions%20to%20connect%20this%20AI%20client%20to%20HyperGSC%20at%20https%3A%2F%2Fhypergsc.com%2Fmcp%20using%20OAuth.%20Preserve%20my%20existing%20configuration.)

[Get started free](/sign-in?redirect=%2Fhome)

Right inside the AI tools you already use
