Microsoft Clarity Data Export Server
by
Fetch Microsoft Clarity analytics data via a Model Context Protocol server, enabling MCP‑compatible clients such as Claude for Desktop to query metrics and dimensions.
Microsoft Clarity Data Export Server Overview
What is Microsoft Clarity Data Export Server about?
Provides a lightweight MCP server that connects to the Microsoft Clarity Data Export API, allowing developers and AI assistants to retrieve recent analytics (1‑3 days) with selectable dimensions and metrics.
How to use Microsoft Clarity Data Export Server?
- Install – either globally with npm (
npm install -g @microsoft/clarity-mcp-server) or run directly with npx:npx @microsoft/clarity-mcp-server --clarity_api_token=YOUR_TOKEN - Configure an MCP client (e.g., Claude for Desktop) by adding a server entry that invokes the above command.
- Invoke the
get-clarity-datatool from the client, supplying:numOfDays(1‑3)- Optional
dimensions(up to 3, e.g., Browser, Device, Country) - Optional
metrics(e.g., Traffic, Scroll Depth) tokenif not passed via CLI.
Key features of Microsoft Clarity Data Export Server
- Simple CLI/NPX execution with a single
--clarity_api_tokenflag. - Supports up to three filter dimensions and a variety of metrics.
- Limits responses to 1,000 rows (no pagination) and caps at 10 API calls per day.
- Works out‑of‑the‑box with Claude for Desktop and any MCP‑compatible client.
- Available as a VS Code extension and a Claude Desktop plugin.
Use cases of Microsoft Clarity Data Export Server
- AI‑assisted reporting – ask an LLM to generate a traffic summary for the last 2 days.
- Dashboard automation – pull metrics into custom internal dashboards without writing HTTP code.
- Rapid prototyping – test dimension‑metric combinations directly from a chat interface.
- Developer tooling – embed clarity data retrieval in VS Code extensions or CI scripts.
FAQ from the Microsoft Clarity Data Export Server
Q: How far back can I retrieve data? A: Only the most recent 1‑3 days are supported by the Clarity export API.
Q: How many dimensions can I use? A: Up to three dimensions per request.
Q: What are the request limits? A: A maximum of 10 API calls per project per day.
Q: Can I paginate results? A: No. The server returns at most 1,000 rows per request.
Q: Do I need to set environment variables?
A: The token can be supplied via the --clarity_api_token CLI argument or as the token tool parameter.
Microsoft Clarity Data Export Server's README
Microsoft Clarity MCP Server
This is a Model Context Protocol (MCP) server for the Microsoft Clarity. It allows you to access your session recordings, project analytics, and documentation from Clarity using Claude for Desktop or other MCP-compatible clients.
Key Features
- Analytics Data Access: Query your Microsoft Clarity analytics data including traffic metrics, user behavior insights, and performance statistics
- Session Recording Retrieval: Access and analyze session recordings to understand user interactions and identify optimization opportunities
- Natural Language Querying: Ask questions in plain English to get insights from your data - no need to learn complex query syntax or API endpoints
- Flexible Data Filtering: Filter results by various dimensions such as browser, device, country, and many more
- Real-Time Data Access: Fetch the latest analytics data and insights from your Clarity projects on-demand
- Documentation Integration: Get quick answers and guidance from Microsoft Clarity documentation directly within your workflow
- Seamless MCP Integration: Works natively with Claude for Desktop, Visual Studio Code, and other Model Context Protocol (MCP) compatible clients
Setup and Installation
Prerequisites
- Node.js v16 or higher
- A Microsoft Clarity account and API token
- Any MCP-compatible client (Claude for Desktop, etc.)
Installation
Option 1: Install via npm (recommended)
You can install and run this package directly using npm:
# Install globally
npm install -g @microsoft/clarity-mcp-server
# Run the server
clarity-mcp-server
Option 2: Run with npx without installing
You can run the server directly using npx without installing:
npx @microsoft/clarity-mcp-server
With either option, you can provide your Clarity API token using the --clarity_api_token parameter:
npx @microsoft/clarity-mcp-server --clarity_api_token=your-token-here
Option 3: Manual Installation
- Clone or download this repository
- Install dependencies:
npm install - Build the TypeScript code:
npm run build - Run the server:
npm run start
Extension/Plugin Installation
Visual Studio Code Extension
Click the button above to install the Microsoft Clarity MCP server directly in Visual Studio Code.
Claude Desktop Plugin
Install from Claude's extension gallery:
- Open Claude Desktop
- Navigate to File → Settings → Extensions
- Search for Microsoft Clarity
- Click Install to add the extension
- Configure your API Token: Follow the instructions in the API Token section to retrieve and set it up correctly.
Configuration
You can provide the Clarity data export API token in two ways:
-
Command Line Arguments:
npx @microsoft/clarity-mcp-server --clarity_api_token=your-token -
Tool Parameters: Provide
tokenas a parameter when calling theget-clarity-datatool
Configuring MCP Clients
Generic 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.
Claude for Desktop Configuration
To configure Claude for Desktop to use this server:
- Open your Claude for Desktop configuration file:
- Windows:
%AppData%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
- Add the configuration shown in the generic example above
- Save the configuration file and restart Claude for Desktop
Server Usage
The server exposes various tools that you can call from any MCP client. Just ask naturally and keep each request focused on one thing.
Query Analytics Dashboard
- Name:
query-analytics-dashboard - Description: Retrieves analytics data and metrics from your project's dashboard using a simplified natural language search query.
- Examples:
- How many Clarity sessions did we get from Egypt in the past 3 days?
- What are the most used browsers in my Clarity project?
- Show me traffic metrics from my Clarity project for the last week
List Session Recordings
- Name:
list-session-recordings - Description: Lists your project's session recordings based on a specified filtering criteria. The filters allow you to narrow down the recordings by various fields such as URLs, device types, browser, OS, country, city, and more.
- Examples:
- List the most recent Clarity sessions from mobile devices
- Show the top 5 Clarity sessions with the highest number of user clicks
- Get Clarity recordings where users encountered JavaScript errors
Query Documentation Resources
- Name:
query-documentation-resources - Description: Retrieves snippets from Microsoft Clarity documentation to find answers to user questions including step-by-step screenshots for setup guides, features, usage, troubleshooting, and integration instructions.
- Examples:
- How to track custom events using Microsoft Clarity?
- How many labels can I add to a recording in Microsoft Clarity?
API Token
Getting Your API Token
To generate an API token:
- Go to your Clarity project
- Select Settings → Data Export → Generate new API token
- Provide a descriptive name for the token
- Save the generated token securely
Privacy Policy
For information about data privacy and usage, please refer to the Microsoft Clarity Privacy Policy.
License
This project is licensed under the MIT License.
Microsoft Clarity Data Export Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Similar MCP Servers like Microsoft Clarity Data Export Server
Explore related MCPs that share similar capabilities and solve comparable challenges
MindsDB
Officialby mindsdb
Enables humans, AI agents, and applications to retrieve highly accurate answers across large‑scale data sources, unifying heterogeneous databases, warehouses, and SaaS platforms.
Vizro
by mckinsey
Build high-quality data visualization apps quickly using a low-code toolkit that leverages Plotly, Dash, and Pydantic.
MCP Server Chart
by antvis
Offers over 25 AntV chart types for automated chart generation and data analysis, callable via MCP tools, CLI, HTTP, SSE, or streamable transports.
Mcp Server Data Exploration
by reading-plus-ai
A versatile tool that enables interactive data exploration through prompts, CSV loading, and script execution.
Wren Engine
by Canner
Provides a semantic engine that lets MCP clients and AI agents query enterprise data with contextual understanding, precise calculations, and built‑in governance.
Google Analytics MCP Server
by surendranb
Provides natural‑language access to Google Analytics 4 data via MCP, exposing over 200 dimensions and metrics for Claude, Cursor and other compatible clients.
BigQuery MCP Server
by ergut
Provides secure, read‑only access to BigQuery datasets, allowing large language models to query and analyze data through a standardized interface.
Mcp Vegalite Server
by isaacwasserman
Provides an interface for LLMs to visualize data using Vega‑Lite syntax, supporting saving of data tables and rendering visualizations as either a full Vega‑Lite specification (text) or a base64‑encoded PNG image.
Google Ads MCP Server
by gomarble-ai
Provides seamless integration of the Google Ads API with Model Context Protocol clients, handling OAuth 2.0 authentication, automatic token refresh, GAQL query execution, account management, and keyword‑research capabilities.