What is Microsoft Clarity?

Clarity is an open-source behavioral analytics tool , with two key goals: privacy & performance.

It helps you understand how users view and use your website across all modern devices and browsers. Understanding how users navigate, interact and browse your website can provide new insights about your users. Empathizing with your users and seeing where features fail or succeed can help improve your product, grow revenue and improve user retention.

Features of Clarity MCP Server

• Query Microsoft Clarity analytics data through a simple interface
• Filter by up to 3 dimensions (Browser, Device, Country/Region, OS, etc.)
• Retrieve various metrics (Scroll Depth, Engagement Time, Traffic, etc.)
• Seamlessly integrates with Claude for Desktop and other MCP clients

Prerequisites

• Node.js v16 or higher
• A Microsoft Clarity account and API token
• Any MCP-compatible client (Claude for Desktop, etc.)

Example MCP Client Configuration

MCP clients typically require configuration to connect to the server. Here's a general example of how to configure an MCP client:

{
  "mcpServers": {
    "@microsoft/clarity-mcp-server": {
      "command": "npx",
      "args": [
        "@microsoft/clarity-mcp-server",
        "--clarity_api_token=your-api-token-here"
      ]
    }
  }
}

The specifics of where and how to add this configuration will depend on your specific MCP client.

Using the Server

When using an MCP client with this server configured, you can ask it to fetch Clarity data. For example:

"Can you fetch my Clarity data for the last day, filtered by Browser and showing Traffic metrics?"

The MCP client will then prompt you to run the get-clarity-data tool, which requires:

• numOfDays: Number of days to retrieve (1-3)
• dimensions: Array of dimensions to filter by (optional)
• metrics: Array of metrics to retrieve (optional)