MCP server for Google PageSpeed Insights & Chrome UX Report APIs — 16 tools to analyze, compare, and optimize web performance with Claude, Cursor, or
MCP server for Google PageSpeed Insights & Chrome UX Report APIs — 16 tools to analyze, compare, and optimize web performance with Claude, Cursor, or any MCP-compatible AI client. That is what the pagespeed mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
Add to ~/.grok/config.toml (global) or <repo>/.grok/config.toml (project-scoped, higher priority):
Installation goes through your MCP client rather than a global install: point it at pagespeed-insights-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
The server publishes 14 tools. What each one is for:
analyze_page_speed — The analyze_page_speed tool exposed by this serverget_performance_summary — The get_performance_summary tool exposed by this serverget_recommendations — Generate smart performance recommendations with priority scoring and actionable fixesclear_cache — Clear the internal cache to force fresh API requests for all subsequent analysesget_visual_analysis — Get screenshots and visual timeline showing how the page loadsget_element_analysis — The get_element_analysis tool exposed by this serverget_network_analysis — Get detailed network waterfall showing all requests with timing and sizeget_javascript_analysis — Get JavaScript execution breakdown showing performance impactget_image_optimization_details — Get specific images needing optimization with exact savings potentialget_render_blocking_details — The get_render_blocking_details tool exposed by this serverget_third_party_impact — The get_third_party_impact tool exposed by this serverget_full_audit — Get comprehensive audit results for all Lighthouse categoriesConfiguration is passed through the environment: GOOGLE_API_KEY, YOUR_GOOGLE_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
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 — analyze_page_speed, get_performance_summary, get_recommendations and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ruslanlap; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| analyze_page_speed | The analyze_page_speed tool exposed by this server. |
| get_performance_summary | The get_performance_summary tool exposed by this server. |
| get_recommendations | Generate smart performance recommendations with priority scoring and actionable fixes. |
| clear_cache | Clear the internal cache to force fresh API requests for all subsequent analyses. |
| get_visual_analysis | Get screenshots and visual timeline showing how the page loads. |
| get_element_analysis | The get_element_analysis tool exposed by this server. |
| get_network_analysis | Get detailed network waterfall showing all requests with timing and size. |
| get_javascript_analysis | Get JavaScript execution breakdown showing performance impact. |
| get_image_optimization_details | Get specific images needing optimization with exact savings potential. |
| get_render_blocking_details | The get_render_blocking_details tool exposed by this server. |
| get_third_party_impact | The get_third_party_impact tool exposed by this server. |
| get_full_audit | Get comprehensive audit results for all Lighthouse categories. |
| crux_summary | Get real-world Core Web Vitals from the Chrome UX Report (field data from actual Chrome users). |
| compare_pages | The compare_pages tool exposed by this server. |
{
"mcpServers": {
"pagespeed-insights": {
"command": "npx",
"args": ["-y", "-p", "pino-pretty", "-p", "pagespeed-insights-mcp", "pagespeed-insights-mcp"],
"env": {
"GOOGLE_API_KEY": "your-google-api-key-here"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| GOOGLE_API_KEY | Credential the server authenticates with. | Yes |
| YOUR_GOOGLE_API_KEY | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.