How to connect Google Search Console to Codex

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 Connections.
2. Connect the Google account that has access to your website in Search Console.
3. Choose the website you want to share and save your selection.

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 Connections

2. Add HyperGSC to Codex

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

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

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:

Use HyperGSC to list my connected Search Console websites.

You should see HyperGSC make a tool call and return the website you saved. If more than one appears, tell the assistant which one to use.

Once that works, try your first report:

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