Pagespeed Insights MCP Server

by ruslanlapio.github.ruslanlap/pagespeed-insights-mcpv2.1.0

Google PageSpeed Insights, CrUX and Lighthouse analysis: page comparison, real-user data, batch runs, regression tracking, diagnostics and recommendations.

68Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active5d ago

Install Pagespeed Insights MCP server

claude mcp add pagespeed-insights -e GOOGLE_API_KEY='<google-api-key>' -- npx -y pagespeed-insights-mcp

{
  "mcpServers": {
    "pagespeed-insights": {
      "command": "npx",
      "args": [
        "-y",
        "pagespeed-insights-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "pagespeed-insights": {
      "command": "npx",
      "args": [
        "-y",
        "pagespeed-insights-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "pagespeed-insights": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pagespeed-insights-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "pagespeed-insights": {
      "command": "npx",
      "args": [
        "-y",
        "pagespeed-insights-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<google-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_API_KEY	yes	yes	Google API key with PageSpeed Insights API enabled

Freshness

Active — last maintenance signal 5d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 5d ago · GitHub
Latest release
2026-09-11 · 28d ago · GitHub · v2.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-12 · 28d ago · official registry · v2.1.0

FAQ

›How do I install the Pagespeed Insights MCP server in Claude Code?

Run: claude mcp add pagespeed-insights -e GOOGLE_API_KEY='<google-api-key>' -- npx -y pagespeed-insights-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Pagespeed Insights require an API key?

Yes. It expects GOOGLE_API_KEY, of which 1 is a secret.

›Can I use Pagespeed Insights as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Pagespeed Insights in the official MCP registry?

Yes, as io.github.ruslanlap/pagespeed-insights-mcp.