Pagespeed MCP Server

CLI tool for batch Google PageSpeed Insights analysis with CSV/JSON/HTML reports

Local serverstdioPython

What is the Pagespeed MCP server?

Pagespeed MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. CLI tool for batch Google PageSpeed Insights analysis with CSV/JSON/HTML reports.

What you get

A command-line tool that automates Google PageSpeed Insights analysis across multiple URLs, extracting performance metrics (lab + field data) into structured CSV, JSON, and HTML reports.

What the assistant can call

Once Pagespeed is connected, these are the calls the assistant has available:

  • Development — The Development tool exposed by this server

Setting it up

The server ships on PyPI as pagespeed, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration and credentials

You will need 2 environment variables: PAGESPEED_API_KEY, YOUR_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Python 3.13+ - Google API key (optional) — without one, you're limited to ~25 queries/day; with one, ~25,000/day

Choosing this one

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Pagespeed's toolset — Development — is a fair guide to whether it matches your workflow.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the pagespeed mcp server does with a few real requests.

Available tools

ToolWhat it does
DevelopmentThe Development tool exposed by this server.

How to install the Pagespeed MCP server

{
  "mcpServers": {
    "pagespeed-4": {
      "command": "uvx",
      "args": ["pagespeed"],
      "env": {
        "PAGESPEED_API_KEY": "your-value",
        "YOUR_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.13+ - Google API key (optional) — without one, you're limited to ~25 queries/day; with one, ~25,000/day
VariableDescriptionRequired
PAGESPEED_API_KEYCredential the server authenticates with.Yes
YOUR_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Pagespeed to Development.

Frequently asked questions

It connects Pagespeed to MCP-compatible AI assistants such as Claude and Cursor, exposing 1 tool (Development) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Pagespeed directly.