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
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.
- 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
- 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
- 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)
- 4Composio Microsoft Clarity toolkitHosted
Who it is for: Developers building agents
Clarity access: 1 tool: Data Export
Price: Free Hobby tier, then usage
- 5Pipedream Microsoft ClarityHosted
Who it is for: Developers who already use Pipedream
Clarity access: 1 action: Get Live Insights
Price: See Pipedream pricing
- 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
- 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
| # | MCP server | Runs | Who it is for | Clarity access | Price |
|---|---|---|---|---|---|
| 1 | Ryze AI MCP | Hosted | Teams that want read-only Clarity answers in Claude or ChatGPT | 1 read tool: behavior metrics for 1 to 3 days, up to 3 breakdowns | From $89 a month, 7-day free trial |
| 2 | Microsoft clarity-mcp-server | Local (npx) | Anyone who wants the full Clarity feature set in an MCP client | About 25 tools: analytics, recordings, AI Visibility, docs search | Package is free (MIT); README lists no price |
| 3 | Insightful Pipe Clarity MCP | Hosted | Teams that already use Insightful Pipe | 1 read action: natural language dashboard query | From $29.99 a month, 7-day trial (all its servers) |
| 4 | Composio Microsoft Clarity toolkit | Hosted | Developers building agents | 1 tool: Data Export | Free Hobby tier, then usage |
| 5 | Pipedream Microsoft Clarity | Hosted | Developers who already use Pipedream | 1 action: Get Live Insights | See Pipedream pricing |
| 6 | surendranb/microsoft-clarity-mcp | Local (uvx or npx) | Developers who want friction triage and a request counter | 3 data tools plus helper tools | Free |
| 7 | Mad7droid/clarity-mcp-server | Local (Node) | Developers who want history past 3 days | 3 tools with local daily snapshots | 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.
@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
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
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
| Option | Where it runs | Who it is for | Auth |
|---|---|---|---|
| @microsoft/clarity-mcp-server 3.0.0 | Your computer, via npx | Users who want recordings, AI Visibility and docs search in an MCP client | OAuth with a Clarity account |
| Clarity entry in Claude Desktop Connectors | Your computer | Claude Desktop users, per the README | OAuth with a Clarity account |
| Clarity Data Export API | Microsoft, over HTTPS | Anything that calls the API, including the hosted servers above | 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):
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
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
Dimensions
- Value
- Up to 3 per request
- What it means for an agent
- Break down by device, campaign and URL, not more
Rows
- Value
- 1,000 per response, no pagination
- What it means for an agent
- A site with many URLs can get cut off
Time zone
- Value
- UTC
- What it means for an agent
- Day boundaries differ from your local day
| Limit | Value | What it means for an agent |
|---|---|---|
| Requests | 10 per project per day | A chat that asks 10 questions can use the whole day's budget |
| Date range | The previous 1 to 3 days (numOfDays 1, 2 or 3) | Weekly and monthly trends are not available |
| Dimensions | Up to 3 per request | Break down by device, campaign and URL, not more |
| Rows | 1,000 per response, no pagination | A site with many URLs can get cut off |
| Time zone | UTC | 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.
A table by device comes back. A server without project access cannot answer.
This checks that the friction metrics are included and that the date range stays within 3 days.
Two metrics are broken down by two dimensions in one call, which uses 1 of the day's requests.
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.
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
Checked November 19, 2026
- GitHub: microsoft/clarity-mcp-server
- npm: @microsoft/clarity-mcp-server
- Microsoft Learn: Clarity Data Export API
- GitHub: Insightful-Pipe/microsoft-clarity-mcp-server
- Composio: Microsoft Clarity toolkit
- Pipedream: Microsoft Clarity
- GitHub: surendranb/microsoft-clarity-mcp
- GitHub: Mad7droid/clarity-mcp-server
- Ryze AI: Connect Microsoft Clarity
- Ryze AI: Claude
- Ryze AI: permissions
- Ryze AI: plans
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?
Does Microsoft Clarity have an official MCP server?
Is the Microsoft Clarity MCP server free?
Can an MCP server watch Clarity session recordings?
Show 6 more questionsShow fewer questions
How far back can a Clarity MCP server look?
What Clarity API limits apply to an MCP server?
Can an MCP server change my Clarity project?
Where do I get a Clarity API token?
Can I connect more than one Clarity project?
Which Ryze AI plan includes the Clarity tool?
Related guides
Microsoft Clarity MCP server
The Ryze AI Clarity tool, setup per client and limits.
Best MCP for PostHog
PostHog MCP servers compared on access, auth and price.
Best MCP for Google Analytics
GA4 MCP servers compared on access, setup and price.
All integrations
Every platform and AI client Ryze AI connects to.





