We show you how to connect the GTmetrix MCP with OpenAI’s Codex.

---

 

Overview

The GTmetrix MCP can be connected to OpenAI’s Codex in order to integrate GTmetrix workflow directly into Codex.

In this guide, we’ll show you how to connect the GTmetrix MCP to Codex with step-by-step instructions.

 

---

 

Connecting GTmetrix MCP to Codex

There are 2 primary ways to connect the GTmetrix MCP to Codex:

• Using OAuth
• Using TOML

We provide step-by-step guidance for each method below:
 

---

 

Using OAuth

The simplest and quickest method to connect to the GTmetrix MCP is by using OAuth – you can connect with just a few clicks.
 

1) Navigate to Settings using the Sidebar

You can also use the Ctrl + comma keyboard shortcut on Windows/Linux (Cmd + comma on Mac).
 

 

2) Click on MCP servers

 

 

3) Click “Add server”

 

 

4) Enter MCP details

• Name: GTmetrix
• Select Streamable HTTP
• URL: https://gtmetrix.com/mcp

Leave everything else empty – Click Save once you’ve entered the required details.
 

 

5) Authenticate your Connection

Click Authenticate – This will launch a new browser window asking you to log into GTmetrix.
 

 

• Log into your GTmetrix account
• Click Allow to authorize your connection

 

 
A success screen should appear when the connection is successfully established.
 

6) Restart/Open Codex and Confirm Connection

To confirm, restart Codex, then start a new chat and ask Codex if it can see the GTmetrix MCP tools.
 

 
If Codex responds with a list of GTmetrix tools, you know that the connection was successful and you can now start interacting with Codex and get it to use GTmetrix.
 

---

 

Using TOML

If you prefer to manually configure the GTmetrix MCP server in your Codex configuration files, you can do so with the instructions below:
 

1) Make sure you’ve generated an API key for your account on the GTmetrix account page

 

 
Copy your API key and keep it aside safely as you’ll need it to set up the MCP connection.
 

 
For security reasons, the screenshot above says YOUR_API_KEY but your Account page will display your actual API key.
 

2) Edit your config.toml file

• Windows: C:/Users/<%USER%>/.codex/config.toml
• Mac: ~/.codex/config.toml

Open this file in a text/code editor.
 

3) Add the gtmetrix MCP

Add the following code to the very bottom of the file:

[mcp_servers.gtmetrix]
url = "https://gtmetrix.com/mcp"

[mcp_servers.gtmetrix.http_headers]
Authorization = "Bearer YOUR_API_KEY"

where YOUR_API_KEY is your API key that you previously copied from the Account page.
 

4) Save the file and restart Codex

Save the config file, then quit the Codex Desktop app entirely and restart it to apply the changes.
 

5) Confirm Connection

Restart Codex, then start a new chat and ask Codex if it can see the GTmetrix MCP tools.
 

 
If Codex responds with a list of GTmetrix tools, you know that the connection was successful and you can now start interacting with Codex and get it to use GTmetrix.

 

---

 

Summary

Connecting the GTmetrix MCP to Codex is quick, simple, and can be done in multiple ways:

• OAuth authentication
• Editing the TOML config

Use the GTmetrix MCP connection to bring your GTmetrix workflows directly into Codex.

Get Codex to start GTmetrix tests, test in different scenarios (locations/devices/connection speeds, etc.), compare results, and help you understand what’s slowing down your page and how to fix them.

Give this a try and let us know if you run into any bugs or issues.

 

---