What it does

Queries the Clarity data export API for session metrics, heatmap data, and page behavior. Useful when the question is 'where do people stop reading' and the answer should come from measurements rather than opinion. Export data lags, so treat it as a weekly signal, not a live dashboard.

Install

Terminal

npx -y @microsoft/clarity-mcp-server

Client configuration

Paste this into your MCP client config (Claude Desktop, Cursor, or any client that reads mcpServers), then restart the client.

mcp.json

{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ]
    }
  }
}

Use it for

Pulling session-behavior metrics into a UX review

Skip it if

Sites without Clarity installed, or anyone expecting real-time data

When to use it

Reach for this when the task needs analytics inside the agent loop. Skip it if a plain shell command or a one-off script is enough — every server you add costs context and adds a failure mode.

Other TypeScript servers

Filesystem — Gives an agent scoped read, write, and search access to directories you explicitly allow
Memory — A persistent knowledge graph stored in a local JSON file, exposed through entities, relations, and observations
Sequential Thinking — Gives the model a scratchpad for structured, revisable reasoning: numbered thoughts that can branch, revise, and conclude

Microsoft Clarity MCP