lighthouse-mcp — Claude Code MCP server: Lighthouse audits
Runs Google Lighthouse checks on web pages and returns scores and metrics. Use it to inspect performance, accessibility, SEO, or best practices.
claude mcp add lighthouse-mcp -- npx -y lighthouse-mcpWhat lighthouse-mcp does
The server exposes run_audit for a full page check and get_performance_score for a performance score. With a full audit, you can choose categories, emulate a phone or desktop, and switch network throttling on or off. If omitted, all categories are checked with mobile emulation and throttling enabled.
You need Node.js 22.19+ and Chrome or Chromium. Audits run serially, with a time limit for each; Chrome and the audit proxy are shut down when a run ends or fails. Loopback access is allowed by default, while private and metadata destinations are blocked. Because a page may reach services on your own machine through loopback, only audit sites you trust.
What it helps with
- get a performance score for a page
- check a site’s accessibility and SEO
- run an audit with desktop or mobile emulation
- choose which Lighthouse categories to inspect
- compare checks with network throttling enabled or disabled
Example prompts for the agent
- Run a Lighthouse audit of
https://example.comfor performance and accessibility on desktop. - Get the mobile performance score for
https://example.com. - Check
https://example.comfor SEO and best practices.
How to install lighthouse-mcp
Platform CLI
claude mcp add lighthouse-mcp -- npx -y lighthouse-mcpPlatform CLI
codex mcp add lighthouse-mcp -- npx -y lighthouse-mcpConfig file
{
"mcpServers": {
"lighthouse-mcp": {
"command": "npx",
"args": [
"-y",
"lighthouse-mcp"
]
}
}
}Config file
{
"servers": {
"lighthouse-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"lighthouse-mcp"
]
}
}
}Platform CLI
gemini mcp add lighthouse-mcp npx -y lighthouse-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about lighthouse-mcp
How do I install lighthouse-mcp in Claude Code?
Run claude mcp add lighthouse-mcp -- npx -y lighthouse-mcp. The server requires Node.js 22.19+ and Chrome or Chromium.
What does lighthouse-mcp do?
It runs Lighthouse against a URL and returns audit metrics or a performance score. Full audits can target selected categories and emulate a mobile or desktop device.
Which destinations can lighthouse-mcp audit?
Loopback destinations are permitted by default; private, link-local, and metadata destinations are blocked. Set AUDIT_ALLOW_LOOPBACK=false to block loopback access too.
