Clarity MCP Server

Traffic, scroll depth, and engagement time are among the Clarity metrics available for analysis through this project. The query-analytics-dashboard tool accepts a natural-language question focused on a single data retrieval or aggregation task, with an explicit time range where possible. Analytics can be filtered using dimensions such as browser, device, country or region, and operating system. The server uses stdio to connect with MCP clients, including Claude for Desktop.

The recording workflow uses list-session-recordings to find sessions matching criteria such as URL, device type, browser, operating system, country, or city. A date filter is required in UTC ISO 8601 format. For questions about Clarity itself, query-documentation-resources retrieves documentation snippets rather than analytics data. Its scope covers setup, features, usage, troubleshooting, and integrations, including step-by-step screenshots for setup guidance. Documentation queries, like analytics queries, are intended to address a single focused topic rather than combine several unrelated requests.