• DATA
  • VIDEO
  • USERS
  • HUMAN

How to inspect user behavior via heatmaps with your AI

Connect Hotjar to your AI client once. From there, you can ask your agent to pull specific heatmap data or watch session recordings to find friction points.

Ask AI about this page

Short answer

How can I use AI to look at Hotjar heatmaps and recordings?

Your AI uses Hotjar tools to fetch heatmap data and specific user sessions based on your questions. You'll get clear answers about click patterns and user friction without manual searching.

The outcomes

Where your insights land

The AI handles the data retrieval so you can focus on the UX.

DATA

Heatmap insights

The AI pulls specific heatmap information for your pages. You get a clear view of where users click or scroll.

VIDEO

Session recordings

Your agent finds and retrieves specific session recordings. This lets you see the exact path a user took.

USERS

User identification

You can ask the AI to find data for a particular user. This connects specific behaviors to individual sessions.

HUMAN

UX decisions

The AI provides the data, but you decide how to fix the UI. You'll use these findings to redesign elements.

The workflow

What your AI does when the data arrives.

The AI acts as a bridge between your questions and the Hotjar database.

  1. Find heatmaps

    The AI scans your available Hotjar heatmaps to find the ones relevant to your request.

    list_heatmaps

  2. Get heatmap data

    Once the right heatmap is found, the AI pulls the specific interaction data you asked for.

    get_heatmap

  3. Locate users

    If you're looking for a specific person's behavior, the AI searches for their profile.

    lookup_user

  4. Fetch recordings

    The AI retrieves the video playback for a specific session so you can see the user's movement.

    get_recording

Try it

Copy these to start.

Use these prompts to begin your analysis.

Starting points

These are opening lines. Swap out the page names or user IDs with your actual Hotjar data.

Hotjar Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_683kR8pOstE12JRN5xU20SgKJIMKCpnDIqpqajf9/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Hotjar capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "hotjar-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_683kR8pOstE12JRN5xU20SgKJIMKCpnDIqpqajf9/mcp"
    }
  }
}
Copy into chat04

  • List all the heatmaps available for my checkout page.

  • Get the heatmap data for the homepage to see where people click most.

  • Find the session recording for the user with ID user_98765.

  • Look up the user with email example@gmail.com and show me their recent session recordings.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Hotjar once, then ask.

Just link your account through the Vinkius dashboard. Your credentials stay encrypted, and you can immediately start asking your AI about your user data.

Connect Hotjar to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my Hotjar settings?

    No. The AI can only read heatmap and recording data. It cannot modify your Hotjar account or project settings.

  • 02

    Can the AI delete user recordings?

    No. The tools only allow for retrieving and listing data. Deleting data is a manual action you must take in Hotjar.

  • 03

    Does the AI see everything in my Hotjar account?

    The AI only sees the data it retrieves through the specific tools provided in the manifest.

  • 04

    Can I ask the AI to create a new heatmap?

    No. There is no tool available to create or configure new heatmaps.

  • 05

    How does the AI find a specific user?

    It uses the lookup tool to find a user profile, which then allows it to find related recordings.

  • More questions about Hotjar? See everything the Hotjar Connector can do

Connect Hotjar to Claude, Cursor, ChatGPT & more