# 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](/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.

- 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

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

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

Add HyperGSC to Codex

bash

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

Sign in to HyperGSC

bash

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

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

- [OpenAI: Codex MCP commands](https://learn.chatgpt.com/docs/cli/reference)

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

## A better Search Console for you and your agents

Set up Codex

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

Right inside the AI tools you already use
