Skip to content

How to connect Google Search Console to Gemini

Connect Google Search Console to Gemini with HyperGSC. Add a custom app on the web or use Gemini CLI, sign in and run your first report.

Carl Brownson

Quick answer

  • Connect your Google account in HyperGSC. Your Search Console sites connect automatically; disable any you do not need under Sites in Settings.
  • Add HyperGSC as a custom app in Gemini’s Connected Apps settings and finish browser sign-in, or configure Gemini CLI.
  • Ask Gemini to list your connected Search Console websites, then use the returned property in your first report.

What you need

  • A Google account with access to your website in Search Console.
  • A HyperGSC account.
  • For Gemini Apps: a personal Google account, age 18 or over, in the US, with Keep Activity on. Custom apps currently work in English; work and school accounts are not supported.
  • Alternatively, Gemini CLI installed and signed in for terminal setup.

1. Connect your website in HyperGSC

  1. Sign in to HyperGSC and open Settings.
  2. Connect the Google account that has access to your website in Search Console.
  3. Your first 250 discovered properties connect automatically across your Google accounts. Disable individual sites under Sites if you do not want to share them.

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.

2. Add HyperGSC to Gemini

  1. Open Gemini on the web. Go to Settings → Connected Apps; some accounts show this under Personal Intelligence.
  2. Under Custom apps, add a custom app and paste the server URL below.
  3. Choose Next, sign in to HyperGSC and approve access in the browser.
  4. In a new prompt, type @ and select HyperGSC to use its tools.
HyperGSC server URL
https://hypergsc.com/mcp

HyperGSC supports automatic OAuth client registration, so you do not need to supply your own client ID or secret. Once connected on the web, the custom app is also available in Gemini’s mobile app.

Using Gemini CLI?

Add hypergsc to mcpServers in ~/.gemini/settings.json. Merge it alongside any existing servers rather than replacing your configuration:

Gemini CLI MCP configuration

json

{
  "mcpServers": {
    "hypergsc": {
      "httpUrl": "https://hypergsc.com/mcp"
    }
  }
}

Start a new Gemini CLI session. Run /mcp auth hypergsc and finish browser sign-in. Use /mcp to check that HyperGSC is connected, then try the connection check below.

3. Check the connection

Send this in Gemini:

Connection check prompt
Use HyperGSC to list my connected Search Console websites.

The assistant should list the websites you enabled in HyperGSC. Choose one of the returned properties, then try your first report:

First report prompt
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. Open the tool result to check the website, dates and filters. Recent Search Console data can be delayed or incomplete; use complete days for comparisons.

If something does not work

  • No Custom apps option? Check Gemini’s account, age, region, language and Keep Activity requirements above, or use Gemini CLI.
  • Gemini answers without using HyperGSC? Type @ and select the custom app before sending the connection check.
  • Gemini CLI is disconnected? Check that the configuration uses httpUrl, then run /mcp auth hypergsc to sign in again.
  • Your website is missing? Check the connected Google account in HyperGSC Settings, refresh sites and make sure the property is enabled under Sites.
  • No rows or different totals? Match the website, dates, search type, country, device and grouping with Search Console. Check that the dates fall within your plan’s history.
  • A tool is unavailable or a quota is reached? Ask which reports your HyperGSC plan supports and how much allowance remains. Reconnecting does not reset quotas.

Common questions

Sources and further reading

A better Search Console
for you and your agents

Right inside the AI tools you already use