How to Coect the GTmetrix MCP With Claude

We show you how to coect the GTmetrix MCP with Claude.

The GTmetrix MCP can be coected to Claude in order to integrate GTmetrix workflow directly into Claude.

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

There are 3 primary ways to coect the GTmetrix MCP to Claude:

If you are using an organization-managed Claude account, your administrator may restrict the adding of Custom Coectors.

Reach out to your IT team add the GTmetrix MCP to the Organization Settings, or install the MCP via JSON on your local machine.

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

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

Note that the coection procedure is the same on both the desktop app and the browser version.
 

Name: GTmetrix
Remote MCP server URL: https://gtmetrix.com/mcp

No Advanced settings needed, so leave them as-is. Click Add once you’ve entered the required details.

Link your GTmetrix Account by clicking the Coect button.

This will launch a new browser window asking you to authorize the GTmetrix coection.

Log into your GTmetrix account.

Alternatively, click on Continue as Guest if you wish to try it without first creating a GTmetrix account.

Note that Guest testing is highly limited and you’ll need to reauthorize the coection with your GTmetrix account after your Guest API credits have been used up.

Click Allow to authorize your coection.

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

You’ll see the GTmetrix MCP now active with various tools.

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

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

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

Note: These instructions are for Windows devices only – For Mac/Linux, please use our General Instructions prompt.
 

Using a JSON config to coect to the GTmetrix MCP requires an API Key. Go to your GTmetrix Accountpage and click Generate API Key if you don’t already have one.

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

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

Claude Desktop requires Node.js to be installed to execute npx and mcp-remote commands.
Download Node.js and install it for your appropriate OS.

 

Windows Explorer will pop up and display the location of the claude_desktop_config.json file

Open the claude_desktop_config.json file with a text editor.

Note that this config file may already contain other code – so be mindful of brackets.

Add the below code inside the global {}. The main JSON code should be within the "mcpservers":{}.

 "mcpServers": {
 "gtmetrix": {
 "command": "cmd",
 "args": [
 "/c",
 "npx",
 "-y",
 "[email protected]",
 "https://gtmetrix.com/mcp",
 "--header",
 "Authorization: Bearer YOUR_API_KEY"
 ]
 }
 }

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

Read our troubleshooting guide for JSON formatting if you’re having issues.

Save the config file, then quit the Claude Desktop app entirely and restart it to apply the changes (for browser, close the tab and open a new Claude session).

Start a new chat and ask Claude if it can see the GTmetrix MCP tools.

If Claude responds with a list of GTmetrix tools, that is confirmation that the coection was successful, and you can now start interacting with Claude and get it to use GTmetrix.
 

Use this command in your terminal to install the GTmetrix MCP server with Claude CLI:

claude mcp add gtmetrix https://gtmetrix.com/mcp --transport http --header "Authorization: Bearer YOUR_API_KEY"

Replace YOUR_API_KEY with the API Key generated from your Account page.

Try these tips if you’re encountering issues coecting with the GTmetrix MCP.

After coecting to the GTmetrix MCP (or editing the config file), make sure to quit the App entirely (close the window, quit the app from your taskbar, etc.) and restart to apply the changes.

For Claude Browser, close and reopen the tab to start a new session.
 

If you’re editing your JSON config file to coect to the GTmetrix MCP, note some caveats:

You can use command npm cache clean --force to do so
Verify with command npm cache verify that the cache is empty

You must ensure that the mcpServer block adheres to the structure/content already in place of your config file

If you’re on a Mac or Linux machine, or if you’re facing general issues with the JSON config setup, we’d suggest copying the General Instructions Prompt on the Account page:

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

Use the GTmetrix MCP coection to bring your GTmetrix workflows directly into Claude.

Get Claude to start GTmetrix tests, test in different scenarios (locations/devices/coection 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.

Basic GTmetrix Splash

Run more tests with additional API credits. Use GTmetrix MCP inside Claude to automate testing, compare results, access history, and surface actionable insights.

Available with select PRO plans (excluding Lite plan).

Other features include: Priority access for tests, More Monitored Slots, Access to more locations, Remote Location Monitoring, Complete Mobile testing suite, and more!

Upgrade to PRO today

Sign up today and get a suite of features and options to make optimizing your website speed clear and easy!

Almost done! Check your e-mail for a validation link.
Click on it to activate your account.

Resend validation e-mail.

Didn't get the e-mail? - Contact us.

Enter your e-mail address below to begin the process of resetting your password.