How to Use the Hotjar MCP in Claude

Q: How do I connect the Hotjar MCP Server to Claude Desktop?

Open your claudedesktopconfig.json file and add the Hotjar server configuration block. Restart Claude Desktop, and you will see the new tools available via the hammer icon in your chat window.

Q: What sites can I access with Hotjar in Claude Desktop?

Run listsites inside Claude Desktop to see all tracked domains associated with your Hotjar API key. You can switch between different web properties inside the desktop chat by passing the correct site ID to any of the analytical tools.

Run Hotjar queries directly from Claude Desktop to pull user session details and heatmap statistics without switching windows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hotjar MCP to Claude Desktop

Create your Vinkius account to connect Hotjar to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Hotjar with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull session recordings into Claude Desktop

The `list_recordings` tool exposes actual Hotjar user sessions directly inside your Claude Desktop chat window so you can diagnose broken UI elements immediately. Calling `get_recording` in Claude Desktop lets you pinpoint exactly where users got stuck on a specific page. Your Claude Desktop client reads this Hotjar behavioral data to find bugs that standard error trackers miss. Avoid bouncing back and forth between Hotjar browser tabs and your Claude Desktop workspace to find out why your signup conversion dropped today.

Analyze survey feedback inside your workspace

The `list_surveys` tool brings Hotjar user feedback directly to your Claude Desktop environment for instant sentiment extraction. By using `get_survey_stats` and `list_survey_responses`, your desktop agent spots trends in customer complaints without manual export steps. This local MCP setup lets you run Claude Desktop scripts that parse thousands of text feedback responses in seconds. Claude Desktop can analyze Hotjar user frustrations and write a summary report based on raw feedback data when you ask.

Connect Hotjar MCP Server to map user drop-offs

The `list_funnels` tool reveals the exact steps where your website visitors abandon their checkout flows, feeding this data directly to Claude Desktop. Once you identify the leaking step in your desktop app, call `get_heatmap` to inspect visual click maps of that specific URL. This integration lets your Claude Desktop agent match Hotjar drop-off metrics with actual user actions. Inspect where people click, where they ignore buttons, and where they get confused inside your Claude Desktop chat.

Setup guide

Set up Hotjar MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Hotjar MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Hotjar MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under hotjar-mcp.

json

{
  "mcpServers": {
    "hotjar-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Hotjar. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Hotjar now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Hotjar MCP in Claude Desktop

Open your claude_desktop_config.json file and add the Hotjar server configuration block. Restart Claude Desktop, and you will see the new tools available via the hammer icon in your chat window.

No, you cannot build or launch new surveys using Claude Desktop. This toolset lets you use `list_surveys` and `get_survey_stats` to pull existing Hotjar feedback data directly into your desktop chat.

Yes, because the Claude Desktop app runs locally, your agent can save pulled Hotjar session data directly to your local workspace. This lets you write reports or save JSON outputs using local filesystem tools in Claude Desktop.

Run `list_sites` inside Claude Desktop to see all tracked domains associated with your Hotjar API key. You can switch between different web properties inside the desktop chat by passing the correct site ID to any of the analytical tools.

The Claude Desktop client retrieves Hotjar session data via HTTPS using your API token. Your sensitive user data remains protected because Vinkius runs the server in an isolated sandbox, keeping your API keys and raw customer recordings secure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript