Ira Bodnar··Updated ·8 min read

Best Microsoft Clarity MCP server: 7 options compared

Quick answer: Microsoft's own @microsoft/clarity-mcp-server is the broadest option: version 3.0.0 signs in with OAuth, runs on your computer and exposes about 25 tools. Ryze AI is the best Microsoft Clarity MCP server for read-only behavior questions from Claude or ChatGPT without installing anything, with one caveat: it has 1 Clarity tool and only sees the last 1 to 3 days.

Below: 7 servers checked on November 19, 2026, Microsoft's own server, the API limits they all share and test prompts.

Ryze AI · Paid Ads

Microsoft Clarity in the Ryze AI connector

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The best Microsoft Clarity MCP servers at a glance

Ranked for people who want Claude or ChatGPT to answer questions about visitor behavior without installing a server or changing the Clarity project. Ryze AI publishes this page, so rank 1 is on that axis only.

  1. 1Ryze AI MCPHosted

    Who it is for: Teams that want read-only Clarity answers in Claude or ChatGPT

    Clarity access: 1 read tool: behavior metrics for 1 to 3 days, up to 3 breakdowns

    Price: From $89 a month, 7-day free trial

  2. 2Microsoft clarity-mcp-serverLocal (npx)

    Who it is for: Anyone who wants the full Clarity feature set in an MCP client

    Clarity access: About 25 tools: analytics, recordings, AI Visibility, docs search

    Price: Package is free (MIT); README lists no price

  3. 3Insightful Pipe Clarity MCPHosted

    Who it is for: Teams that already use Insightful Pipe

    Clarity access: 1 read action: natural language dashboard query

    Price: From $29.99 a month, 7-day trial (all its servers)

  4. 4Composio Microsoft Clarity toolkitHosted

    Who it is for: Developers building agents

    Clarity access: 1 tool: Data Export

    Price: Free Hobby tier, then usage

  5. 5Pipedream Microsoft ClarityHosted

    Who it is for: Developers who already use Pipedream

    Clarity access: 1 action: Get Live Insights

    Price: See Pipedream pricing

  6. 6surendranb/microsoft-clarity-mcpLocal (uvx or npx)

    Who it is for: Developers who want friction triage and a request counter

    Clarity access: 3 data tools plus helper tools

    Price: Free

  7. 7Mad7droid/clarity-mcp-serverLocal (Node)

    Who it is for: Developers who want history past 3 days

    Clarity access: 3 tools with local daily snapshots

    Price: Free

All 7 servers read Clarity data. Row 2 also has tools that create, regenerate and delete AI Visibility topic reports. Rows 3 to 7 and Ryze AI use the Data Export API token, which carries the limits in the API limits section.

How these Microsoft Clarity MCP servers were compared

Each server was checked against its own README, docs page or registry entry on November 19, 2026. No customer Clarity data was used, and no server was run for this page.

  • Where it runs: hosted, or a process on your own computer.
  • Sign-in: a Clarity API token, OAuth with a Microsoft Clarity account, or a vendor account.
  • Clarity access: which data it reads and whether any tool changes something.
  • Upkeep and price: last commit, stars and what it costs. Repos with 0 stars are marked as unproven.

Microsoft's server ranks second because the axis here is a hosted, read-only connection that needs no install. For the Ryze AI setup, read the Microsoft Clarity MCP page.

The 7 Microsoft Clarity MCP servers, one by one

1. Ryze AI MCP

A hosted MCP server you add to Claude or ChatGPT as one connector URL, https://connector.get-ryze.ai/mcp. Clarity connects with a Data Export API token for one project. Disclosure: Ryze AI publishes this page.

Clarity tools

1: clarity__read. It fetches behavior insights for the last 1 to 3 days: traffic, scroll depth, engagement time, popular pages, referrers, dead clicks, rage clicks, excessive scrolling, quickbacks and script and error clicks, split by up to 3 dimensions.

Guardrail

The only Clarity tool is a read tool, so the connector does not change anything in Clarity. In Claude, approvals are set per tool under Tool permissions.

Limit

One Clarity project per connection, because the token belongs to one project. No session recordings or heatmaps.

Price

A Ryze AI plan or trial; Paid Ads is $89 a month with a 7-day free trial. Connecting is free.

Setup steps and the tool details are on the Microsoft Clarity MCP page. The Ryze AI help center has the connection guide.

2. Microsoft clarity-mcp-server

Microsoft's clarity-mcp-server has 144 stars, an MIT license and a last commit on November 17, 2026. The npm package @microsoft/clarity-mcp-server is at version 3.0.0, published November 16, 2026, and had 31,605 downloads in the week of November 12 to 18. It runs on your computer through npx and needs Node.js 16 or higher.

Tools

About 25, by the README's lists: query-analytics-dashboard, list-session-recordings, 6 AI Visibility citation tools, 9 Bot Activity tools, 7 Topic Insights tools and query-documentation-resources.

Sign-in

OAuth with your Microsoft Clarity account, started by asking the client to sign in. The README says Data Export API token authentication for this server is being deprecated and gives a migration path. It asks for admin or member access to at least one project.

Changes

Mostly reads. The Topic Insights tools can create, regenerate and delete reports; the README says these need an OAuth sign-in and enough project permission, and deletion must be confirmed first.

Setup

Add the npx config to an MCP client. The README names Visual Studio Code and Claude Desktop, where it is also listed under Customize, Connectors.

Note

Bot Activity needs a CDN connected to the project, and Topic Insights needs a verified domain.

3. Insightful Pipe Clarity MCP

A hosted server at https://clarity.insightfulmcp.com/ from Insightful Pipe, with a GitHub page under an MIT license, 0 stars and a last push on October 10, 2026. You sign in to Insightful Pipe, not to Clarity directly.

Tools

1 read action, query_dashboard, which queries the Clarity dashboard in natural language. The README lists 0 write actions.

Clients

Setup steps for Claude, ChatGPT in Developer mode, Claude Code and Cursor.

Controls

Individual actions can be switched on or off per connected account, and a connection can be read-only.

Price

The README says the server is included in every Insightful Pipe plan, from $29.99 a month with a 7-day trial.

4. Composio Microsoft Clarity toolkit

A developer platform that exposes many apps through one MCP gateway or SDK. Its Microsoft Clarity toolkit lists 1 tool, Data Export, which exports the previous 1 to 3 days of dashboard data with up to three dimensions.

Auth

An API key, which is the Clarity bearer token.

Writes

None. The page says the tool only exports and retrieves data.

Price

A free Hobby plan with 100,000 tool calls a month and no credit card. Clarity's own limits still apply.

5. Pipedream Microsoft Clarity

Pipedream's Clarity page lists 1 action, Get Live Insights, and no triggers. The page says every Clarity action is exposed as an MCP tool on Pipedream's remote server, and it signs in with an API key.

Best for

Developers who already run workflows on Pipedream and want the Clarity action inside an agent.

Price

The Clarity page shows no price. Check Pipedream's own pricing page.

6. surendranb/microsoft-clarity-mcp

A community server written with FastMCP, with 0 stars, an MIT license, a last push on November 8, 2026 and an npm package at version 0.1.1. It is new and unproven.

Tools

get_ux_insights, get_frustration_breakdown and get_js_errors for data, plus doctor, skills_list, skill_read and check_for_updates.

Auth

A Clarity API token in the CLARITY_API_TOKEN environment variable, run through uvx or npx.

Quota guard

Responses are cached on disk for 1 hour by default, stale data is served with a warning once the 10 daily requests are used, and each response reports the calls left today.

Note

It sends anonymous usage telemetry unless DO_NOT_TRACK=1, DISABLE_TELEMETRY=1 or CLARITY_TELEMETRY=false is set.

7. Mad7droid/clarity-mcp-server

A community server with 0 stars, an MIT license and a last push on July 24, 2026. It exists to work around the 3-day window.

Tools

get_clarity_insights for live data with an optional URL filter, capture_clarity_snapshot to save today's data locally, and get_clarity_historical_insights to query saved days.

History

Only days you captured are available. The README says data from before you started capturing cannot be recovered.

Setup

Clone, npm install, npm run build, put the token in .env and wire it into Claude Desktop. It needs Node.js 18 or later.

Microsoft's own Clarity MCP options and who each is for

Microsoft publishes one MCP server for Clarity and one export API behind the token-based servers.

  1. @microsoft/clarity-mcp-server 3.0.0

    Where it runs
    Your computer, via npx
    Who it is for
    Users who want recordings, AI Visibility and docs search in an MCP client
    Auth
    OAuth with a Clarity account
  2. Clarity entry in Claude Desktop Connectors

    Where it runs
    Your computer
    Who it is for
    Claude Desktop users, per the README
    Auth
    OAuth with a Clarity account
  3. Clarity Data Export API

    Where it runs
    Microsoft, over HTTPS
    Who it is for
    Anything that calls the API, including the hosted servers above
    Auth
    Bearer token generated by a project admin

The README states that Data Export API token sign-in for Microsoft's own server is being deprecated. The Data Export API itself is documented separately, and the token servers in this list use it. Ryze AI connects Clarity with that token, per its help center.

If you need session recordings or AI Visibility data, use Microsoft's server. If you want read-only behavior metrics in Claude or ChatGPT with nothing installed, the Ryze AI connector fits.

Clarity Data Export API limits that token-based servers share

Servers that sign in with a Data Export token call the project-live-insights endpoint, so its limits apply (Microsoft Learn):

  1. Requests

    Value
    10 per project per day
    What it means for an agent
    A chat that asks 10 questions can use the whole day's budget
  2. Date range

    Value
    The previous 1 to 3 days (numOfDays 1, 2 or 3)
    What it means for an agent
    Weekly and monthly trends are not available
  3. Dimensions

    Value
    Up to 3 per request
    What it means for an agent
    Break down by device, campaign and URL, not more
  4. Rows

    Value
    1,000 per response, no pagination
    What it means for an agent
    A site with many URLs can get cut off
  5. Time zone

    Value
    UTC
    What it means for an agent
    Day boundaries differ from your local day

Microsoft's page states the quota per project, so several servers that use tokens of the same project would draw on one budget. That is a reading of the docs, not something Microsoft states in those words. Past the quota, the API returns 429 with the message Exceeded daily limit.

How to choose a Microsoft Clarity MCP server

Start from whether you need recordings, whether you will install something and how far back you need to look.

You want read-only behavior answers in Claude or ChatGPT

Ryze AI MCP

One read tool and a Clarity token, nothing to install. Related analytics page: best MCP for Google Analytics.

You want recordings, AI Visibility and docs search

Microsoft clarity-mcp-server

OAuth sign-in and the broadest tool list, run locally.

You already pay for Insightful Pipe

Insightful Pipe Clarity MCP

A hosted server with per-action switches.

You build agents over many apps

Composio or Pipedream

A single Clarity tool inside a larger platform.

You want a request counter and friction triage

surendranb/microsoft-clarity-mcp

Caching and quota reporting, but new and unproven.

You want history beyond 3 days

Mad7droid/clarity-mcp-server

Saves daily snapshots, from the day you start.

Comparing with another product analytics tool? See best MCP for PostHog and best MCP for Amplitude. Everything else is on the Integrations hub.

Prompts to test any Microsoft Clarity MCP server

Run these first. Each fits inside the 10 requests a day and none asks for a change.

Traffic by device
Show Clarity sessions for the last 1 day split by device. Tell me which project you used and do not change anything.

A table by device comes back. A server without project access cannot answer.

Friction on one page
Which URLs had the most rage clicks and dead clicks in the last 3 days?

This checks that the friction metrics are included and that the date range stays within 3 days.

Campaign breakdown
Split scroll depth and engagement time by campaign and URL for the last 2 days.

Two metrics are broken down by two dimensions in one call, which uses 1 of the day's requests.

Window check
Compare this week with last week.

A token-based server should say it only sees the last 1 to 3 days. One that claims a weekly trend is not reading the Data Export API.

Request budget
How many Clarity requests do I have left today?

Servers with a quota counter, such as surendranb, answer. Others cannot know.

Access and safety checklist before you connect

  • Generate the token as a project admin: in Clarity open Settings, Data Export, Generate new API token. Microsoft says only project admins can manage tokens.
  • Name tokens by server: a name is 4 to 32 characters, with letters, numbers, hyphens, underscores and periods, and it must be unique in the project.
  • Know the scope of a token: each token belongs to one project.
  • Prefer OAuth if you run Microsoft's server: the README says token sign-in for it is being deprecated.
  • Set approvals: in Claude, approvals are set per tool under Customize, Connectors, Ryze AI, Tool permissions. The Ryze AI chat starts on Skip all approvals, and scheduled tasks run without an approval step.
  • Rotate on departures: Microsoft advises replacing tokens when a user with access leaves the project.
  • Check telemetry: read each local server's README for usage data before you run it.

More on connecting: the Ryze AI help center has the Microsoft Clarity guide.

Sources

The verdict

Pick by what you need to see. Microsoft's own server covers recordings and AI Visibility from an MCP client on your computer. Developers on Composio or Pipedream can use their one-tool Clarity entries, and people who want hosted, read-only answers about the last 1 to 3 days can use the Ryze AI connector. Whichever you choose, keep the 10 daily requests in mind and start with one focused question.

Frequently asked questions

What is the best Microsoft Clarity MCP server?
Ryze AI is the best Microsoft Clarity MCP server for read-only behavior questions from Claude or ChatGPT without installing anything, with one caveat: it has 1 Clarity tool and only sees the last 1 to 3 days. For recordings and AI Visibility data, use Microsoft's own server.
Does Microsoft Clarity have an official MCP server?
Yes. Microsoft publishes @microsoft/clarity-mcp-server, MIT licensed, at version 3.0.0 on npm. It runs on your computer through npx, signs in with OAuth and lists about 25 tools covering analytics, session recordings, AI Visibility and documentation search.
Is the Microsoft Clarity MCP server free?
Microsoft's server is an MIT licensed package and its README lists no price. Composio has a free Hobby tier of 100,000 tool calls a month, and Insightful Pipe starts at $29.99 a month. Ryze AI needs a plan or trial, from $89 a month with a 7-day free trial.
Can an MCP server watch Clarity session recordings?
Microsoft's server has a list-session-recordings tool that lists recordings by filters such as URL, device and country. The Clarity Data Export API does not return recordings, and the Ryze AI Clarity tool does not provide them.
Show 6 more questions
How far back can a Clarity MCP server look?
Servers that use the Data Export API see only the previous 1 to 3 days. Mad7droid/clarity-mcp-server saves daily snapshots locally, so history builds from the day you start capturing.
What Clarity API limits apply to an MCP server?
The Data Export API allows 10 requests per project per day, 1 to 3 days of data, 3 dimensions per request and 1,000 rows per response, in UTC. A 429 response says Exceeded daily limit.
Can an MCP server change my Clarity project?
Mostly no. The data tools in this list read. Microsoft's server has Topic Insights tools that create, regenerate and delete reports, which need an OAuth sign-in and project permission, and deletion must be confirmed. The Ryze AI Clarity tool is read-only.
Where do I get a Clarity API token?
In Clarity, open the project, then Settings, Data Export, Generate new API token. Only project admins can manage tokens, and each token belongs to one project. Microsoft's own server is moving to OAuth instead.
Can I connect more than one Clarity project?
Ryze AI connects one Clarity project per connection. To switch, disconnect in the Ryze AI app and connect with the other project's token. Another project can live in another workspace, and one Claude or ChatGPT connection can cover up to 20 workspaces.
Which Ryze AI plan includes the Clarity tool?
Any active Ryze AI plan or trial: Paid Ads at $89 a month with a 7-day free trial, SEO Starter at $129 with a 3-day free trial, or Agency at $279. Annual billing saves 30% in the first year.

Related guides

Ryze AI: Microsoft Clarity MCP tool

7-day free trial, $89 a month flat

Start free trial