integrations tools hotjar
Hotjar MCP for your AI agent
Cogny's Hotjar integration exposes 5 tools (5 read) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- 5readonly reads data.
- 0writecreates or changes something.
- 0destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect Hotjar in Cogny. Every Hotjar tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
Notes
Hotjar connects with an API key, which is a Client ID and a Client Secret. Only an Admin of the Hotjar organization can create one, under Settings → API, where you pick the organization and the scope. Cogny also needs the Site ID of each site to read (Hotjar → Sites & Organizations); separate several with commas, and the first is the default.
Hotjar's API is available on Scale plans only: survey responses need Ask Scale. On other plans every call answers 403.
Hotjar API keys expire one year after they're created and can't be extended. When a key expires, Cogny marks the connection as needing a reconnect; generate a new key in Hotjar and paste it in.
Responses come back newest first, at most 100 per call, paged with a cursor. summarize_survey_responses reads up to 2,000 of the newest responses and works out NPS (promoters 9–10, detractors 0–6), rating averages and distributions, counts per choice, Hotjar's sentiment and tag counts, devices, countries and the pages responses came from. Sentiment is only present when your Hotjar plan includes it. Hotjar allows 3,000 API requests per minute.
Known gaps
- Read-only. Hotjar's API has no way to create, edit, turn on or pause a survey, or to tag a response.
- No heatmaps, session recordings, funnels, trends, events or feedback widgets: Hotjar's API doesn't offer them. A response links to its recording when there is one, but the recording itself can't be read.
- Sites can't be listed through the API; they come from the Site ID field on the connection.
- Responses can't be filtered by date, page or answer in the API. To look at one period, page until
created_timeis older than you need. - Multiple-choice answers are counted as the text Hotjar returns for the whole answer; picks within one answer aren't split.
- Hotjar's User Lookup (GDPR data reports and deletion) is not offered: it emails visitors or deletes their data, which isn't something a marketing agent should do.
what each tool does.
Read 5 · only reads data
list_sitesReadLists the Hotjar sites this connection reads and checks that each one answers.list_surveysReadLists the surveys on a Hotjar site, with their type and whether they are live.get_surveyReadShows one Hotjar survey with all its questions, answer choices and rating labels.list_survey_responsesReadLists the answers people gave to a Hotjar survey, newest first.summarize_survey_responsesReadSummarizes a Hotjar survey's results: NPS, rating averages, choice counts, sentiment and sample answers.
Exact input schemas come from tools/list once Hotjar is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.