Skip to content

How to connect Google Search Console to Codex

Connect Google Search Console to Codex with HyperGSC. Add the server, sign in and run your first report.

Carl Brownson

Quick answer

  • Connect your Google account in HyperGSC. Your first Search Console properties connect automatically; unshare individual sites in Connections if needed.
  • Run codex mcp add with https://hypergsc.com/mcp, then codex mcp login hypergsc.
  • Ask Codex 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.
  • The Codex command-line app installed and signed in. These steps use the CLI.

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

2. Add HyperGSC to Codex

Run these commands in your terminal, one at a time:

Add HyperGSC to Codex

bash

codex mcp add hypergsc --url https://hypergsc.com/mcp

Sign in to HyperGSC

bash

codex mcp login hypergsc

Complete the browser sign-in and approve access. Start a new Codex session for the connection check below.

3. Check the connection

Send this in Codex:

Connection check prompt
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
Use HyperGSC for [my website]. Show my top 5 pages by clicks over the latest complete 7 days, and include the dates.

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

If something does not work

  • Server not listed? Run codex mcp list to check that the add command saved HyperGSC.
  • Your website is missing? Check the Google account and saved website selection in HyperGSC Settings.
  • Sign-in failed? Reconnect HyperGSC in Codex and complete the browser sign-in.
  • A report is unavailable? Ask which reports your HyperGSC plan supports.

Common questions

Sources and further reading

A better Search Console
for you and your agents

Right inside the AI tools you already use