Microsoft Clarityvf.sr

listing.by · home.legend.verified

Query Clarity traffic and behavior metrics, list session recordings and search Clarity documentation in plain language.

state.local.long (state.local.title)listing.badge.runs_withstate.key.long

listing.install

listing.local.explain

npx -y @microsoft/clarity-mcp-server

listing.local.needs listing.local.note

  • CLARITY_API_TOKEN listing.env.secret Clarity data export API token (or pass --clarity_api_token).
act.add_to a11y.new_tab

listing.share.h

listing.share.p_local

mcp.tc/i/clarity

listing.about

Connects an assistant to Microsoft Clarity through its data export API. You can ask natural language questions about traffic and user behavior metrics, list session recordings with timeline information, and pull snippets from the Clarity documentation.

Runs locally over stdio with npx (@microsoft/clarity-mcp-server) and needs Node.js. A Clarity data export API token is required, passed with the --clarity_api_token argument. The token is generated in the Clarity project settings under Data Export.

listing.can

  • Query traffic and behavior metrics with natural language
  • Filter data by dimensions such as browser, device and country
  • List session recordings with duration and interaction timeline
  • Search Microsoft Clarity documentation for setup and troubleshooting answers

listing.tools 3

  • list-session-recordings

    List session recordings with session link, duration and a timeline of user interactions.

  • query-documentation-data

    Fetch Clarity documentation snippets for setup, features, usage and troubleshooting questions.

  • query-analytics-data

    Fetch Clarity analytics data using a focused natural language query with an explicit time range.

listing.prov.mcpb_on

listing.prompts

  • How many Clarity sessions did we get from Egypt in the past 3 days?

  • What are the most used browsers in my Clarity project?

  • List the most recent Clarity sessions from mobile devices

  • How do I track custom events using Microsoft Clarity?

listing.setup.h

listing.setup.local

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio clarity --env "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" -- npx -y @microsoft/clarity-mcp-server
  1. Start Claude Code and type /mcp. clarity should show as connected.

Add --scope user to make it available in every project. Replace the placeholders with your own values.

Claude Desktop

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}
  1. Save the file and restart Claude Desktop. Replace the placeholders with your own values.

Needs Node.js on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Add to Cursor a11y.new_tab

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}

Needs Node.js on your computer. Replace the placeholders with your own values.

VS Code

Add it to .vscode/mcp.json. VS Code asks for the secret the first time and stores it securely:

.vscode/mcp.json
{
  "servers": {
    "clarity": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "${input:clarity-api-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "clarity-api-token",
      "description": "CLARITY_API_TOKEN",
      "password": true
    }
  ]
}

Needs Node.js on your computer.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}
  1. Refresh the MCP server list in Cascade. Replace the placeholders with your own values.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add clarity --env "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" -- npx -y @microsoft/clarity-mcp-server

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.clarity]
command = "npx"
args = ["-y", "@microsoft/clarity-mcp-server"]
env = { CLARITY_API_TOKEN = "<YOUR_CLARITY_API_TOKEN>" }

Needs Node.js on your computer. Replace the placeholders with your own values.

Gemini CLI

gemini mcp add -e "CLARITY_API_TOKEN=<YOUR_CLARITY_API_TOKEN>" clarity npx -- -y @microsoft/clarity-mcp-server

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/clarity-mcp-server"
      ],
      "env": {
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>"
      }
    }
  }
}

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs Node.js on your computer. Replace the placeholders with your own values.

listing.faq

Can I paste mcp.tc/i/clarity into my MCP client?

No. Microsoft Clarity runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is npx -y @microsoft/clarity-mcp-server.

Does Microsoft Clarity need an API key?

Yes. It reads CLARITY_API_TOKEN from its environment, and CLARITY_API_TOKEN is a secret. Put the value in your client's config on your own machine, never in a shared file.

Is Microsoft Clarity a remote or a local server?

Local. Your client starts it as a process on your computer with npx -y @microsoft/clarity-mcp-server, which needs Node.js.

What can Microsoft Clarity do?

It has 3 tools: list-session-recordings, query-documentation-data and query-analytics-data. You can query traffic and behavior metrics with natural language, filter data by dimensions such as browser, device and country and list session recordings with duration and interaction timeline.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc's robot read Microsoft Clarity's public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can't confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

listing.em.h

listing.em.lead_local listing.em.how

listing.em.badge

em.prev_lightem.prev_dark
Markdown
[![Microsoft Clarity on mcp.tc](https://mcp.tc/i/clarity/badge.svg)](https://mcp.tc/i/clarity)
HTML
<a href="https://mcp.tc/i/clarity"><img src="https://mcp.tc/i/clarity/badge.svg" alt="Microsoft Clarity on mcp.tc" height="20"></a>

listing.em.badge_note

listing.em.widget

HTML
<script src="https://mcp.tc/w/clarity.js" async></script>

listing.em.widget_note

iframe

HTML
<iframe src="https://mcp.tc/embed/clarity" title="Microsoft Clarity on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

listing.em.iframe_note

JSON

listing.em.json_local

https://mcp.tc/i/clarity.json

listing.em.fields

listing.related

listing.more_in

  • Microsoft Fabricvf.sr

    Microsoft

    state.local.label (state.local.title)

    Give AI agents Microsoft Fabric API specs, item schemas and best practices, plus OneLake file and Data Factory tools.

    mcp.tc/i/microsoft-fabric

  • Power BI Modelingvf.sr

    Microsoft

    state.local.label (state.local.title)

    Create and change Power BI semantic models: tables, measures, relationships and DAX, from models open in Power BI Desktop or PBIP files.

    mcp.tc/i/powerbi-modeling

  • Power BI (Fabric IQ)vf.sr

    Microsoft

    state.auth.label (state.auth.title)

    Find Power BI reports and semantic models, read their metadata and run read-only DAX queries on data you can access.

    mcp.tc/i/power-bi

  • Azure DevOpsvf.sr

    Microsoft

    state.local.label (state.local.title)

    Work with Azure DevOps work items, repos, pull requests, pipelines, wikis and test plans from your AI assistant.

    mcp.tc/i/azure-devops

  • MarkItDownvf.sr

    Microsoft

    state.local.label (state.local.title)

    Convert PDF, Office documents, HTML, images and other files or URLs to Markdown for use in LLM context.

    mcp.tc/i/markitdown

  • Awesome Copilot

    Microsoft

    state.local.label (state.local.title)

    Retrieve GitHub Copilot customization files from the Awesome Copilot repository, such as prompts, instructions and chat modes.

    mcp.tc/i/awesome-copilot

listing.disclaimer_checked