Heap Connector for AI agents.

Q: Can I use the Heap MCP to delete user data for GDPR?

Yes, you can use the deleteuserdata tool to permanently remove a user and all their associated data directly through your AI agent.

Q: Can I check my event definitions?

Yes, you can use the geteventdefinitions tool to list all custom events, ensuring your agent stays aligned with your analytics schema.

Q: Does it support high-throughput tracking?

Yes, the bulktrackevents tool is specifically designed to handle multiple events concurrently for high-volume data needs.

Q: Is this good for identifying anonymous users?

Yes, the identifyuser tool lets you link anonymous sessions to specific identities, which helps consolidate your user journey data.

Q: How do I find my Heap App ID and API Key?

Log in to Heap, go to Account > Projects, and select your project. Your App ID will be visible there. For the API Key, navigate to the API section in your project settings to generate a server-side key.

Q: Can I track events server-side through this integration?

Yes! Use the trackevent tool. You provide the user identity, event name, and optional properties. This is perfect for capturing actions that happen outside the client browser.

12 live capabilities

Manage product analytics and user behavior data through natural conversation.

Live agent request Heap / Connector

Waiting for input…

AI Agent

Why people use Heap

Speed up product analytics with the Heap

With this Connector, you can skip those clicks entirely. Just tell your AI agent to update a property or pull a segment list. It handles the interaction with the platform for you, giving you a direct way to manipulate your data without the usual friction of a web UI.

What Vinkius changes

You get a direct line to your product data without the dashboard fatigue.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Bulk updating user tags

A growth engineer needs to tag 500 users with a 'Beta_Tester' property.
Real-world use case 02

Verifying event schemas

A product manager needs to know if the 'Checkout Started' event is firing correctly.
Real-world use case 03

Handling GDPR requests

A privacy officer gets a request to delete a user's data.

Complete set · 12capabilities

The complete Heap capability set.

These are the exact actions your AI can choose when you ask it to work with Heap.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 12 available through Heap.

01 Capability
Get api usage
Check your current API usage and project status. It helps you monitor limits and ensure your integration is healthy.
02 Capability
Track event
Track a server-side event for a user in Heap. Use this to send custom interaction data with JSON properties.
03 Capability
Get event definitions
List all custom event definitions in Heap. It keeps your agent aligned with your actual analytics schema.
04 Capability
Add account properties
Add or update properties for an account or group of users. This is great for tagging entire organizations with specific metadata.

Capability set02 / 03

05—08

4 capabilities in this set.

Part of 12 available through Heap.

05 Capability
Add user properties
Add or update custom properties for a specific user profile. Use this to enrich your data with unique user attributes.
06 Capability
Bulk add user properties
Update properties for multiple users in a single request. This saves you from manual updates when dealing with large cohorts.
07 Capability
Bulk track events
Track multiple events concurrently for high-throughput needs. This is the best way to send large batches of interaction data.
08 Capability
Delete user data
Permanently delete a user and all their associated data. This ensures you stay compliant with GDPR requirements.

Capability set03 / 03

09—12

4 capabilities in this set.

Part of 12 available through Heap.

09 Capability
Get my profile
Get information about the authenticated API key. Use this to verify which account your agent is currently connected to.
10 Capability
Identify user
Associate an anonymous session with a specific user identity. This helps you stitch together a complete user journey.
11 Capability
Get segments
List all segments defined in your Heap project. Use this to quickly see what cohorts you have available to query.
12 Capability
Query user profiles
Query and filter user profiles based on specific criteria. This lets you find specific users who match your target behavior.

Set up in minutes

One URL. Then ask Heap to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Heap from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Heap, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Heap for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Heap URL.
Step 03

Save and start

Save the connection and enable Heap in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "heap": {
      "url": "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Heap

Open Agent mode in chat and ask: "Using Heap, help me...". 12 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "heap": {
      "url": "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Heap

Ask Copilot: "Using Heap, help me...". 12 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "heap": {
      "url": "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Heap

Open Cascade and ask: "Using Heap, help me...". 12 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "heap": {
      "url": "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Heap

Ask Cline: "Using Heap, help me...". 12 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add heap --transport http "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Heap

Ask Claude: "Using Heap, show me...". 12 tools are ready

Where the request belongs

Work Heap can move forward.

Built around the request

This is for product managers who need instant data, growth engineers who hate manual data entry, and privacy officers who need to handle deletion requests quickly.

Product Manager

Checking segment sizes and verifying event definitions during sprint planning sessions.

Growth Engineer

Automating server-side event tracking and bulk property updates for new user cohorts.

Data Privacy Officer

Executing GDPR data deletion requests via chat without logging into the analytics UI.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

GrowingIO

Leading product analytics platform in China. manage events, segments, and metrics via AI.

View Connector

02 10 capabilities

PostHog

Analyze product data via PostHog. list insights, track persons, inspect feature flags, and monitor experiments directly from any AI agent.

View Connector

03 21 capabilities

Amplitude

Track user behavior, analyze product metrics, and manage cohorts directly from your AI agent using Amplitude's powerful analytics suite.

View Connector

04 8 capabilities

Countly

Manage product analytics via Countly. track user sessions, record custom events, and query deep behavioral metrics directly from your AI agent.

View Connector

05 10 capabilities

TalkingData

Leading big data and product analytics platform in China. manage event tracking and user growth via AI.

View Connector

06 10 capabilities

Mixpanel (Event Analytics & Insights)

Manage product analytics via Mixpanel. query event trends, track conversion funnels, and audit user cohorts.

View Connector

Bring your own AI

Change the model, client or framework. Keep Heap connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Heap.

The practical details behind the request, access and result.

Can I use the Heap MCP to delete user data for GDPR?

Yes, you can use the delete_user_data capability to permanently remove a user and all their associated data directly through your AI agent.

How does this help with growth engineering?

It allows growth engineers to automate high-throughput event tracking and bulk property updates, removing the need for manual data entry in the dashboard.

Can I check my event definitions?

Yes, you can use the get_event_definitions capability to list all custom events, ensuring your agent stays aligned with your analytics schema.

Does it support high-throughput tracking?

Yes, the bulk_track_events capability is specifically designed to handle multiple events concurrently for high-volume data needs.

Can I manage user properties via chat?

Absolutely. You can add or update custom properties for individual users or entire groups of users using natural language commands.

Is this good for identifying anonymous users?

Yes, the identify_user capability lets you link anonymous sessions to specific identities, which helps consolidate your user journey data.

How do I find my Heap App ID and API Key?

Log in to Heap, go to Account > Projects, and select your project. Your App ID will be visible there. For the API Key, navigate to the API section in your project settings to generate a server-side key.

Can I track events server-side through this integration?

Yes! Use the track_event capability. You provide the user identity, event name, and optional properties. This is perfect for capturing actions that happen outside the client browser.

How do I update user properties in bulk?

Use the bulk_add_user_properties capability. You must provide a JSON array containing objects with identity and properties for each user you wish to update.

Is the data deletion capability permanent?

Yes. The delete_user_data capability triggers a permanent deletion of the user identity and all historical data from Heap, helping you comply with GDPR and CCPA requests.

One connection away

Give your agent a direct line to Heap.

Connect Heap once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Speed up product analytics with the Heap

You get a direct line to your product data without the dashboard fatigue.

Bulk updating user tags

Verifying event schemas

Handling GDPR requests

Get api usage

Track event

Get event definitions

Add account properties

Add user properties

Bulk add user properties

Bulk track events

Delete user data

Get my profile

Identify user

Get segments

Query user profiles

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Heap

Create MCP config

Add the server config

Enable Agent mode

Start using Heap

Open MCP Settings

Add the server

Save and reload

Start using Heap

Open Cline MCP Settings

Add remote server

Enable the server

Start using Heap

Install Claude Code

Add the Connector

Verify the connection

Start using Heap

Product Manager

Growth Engineer

Data Privacy Officer

GrowingIO

PostHog

Amplitude

Countly

TalkingData

Mixpanel (Event Analytics & Insights)

Give your agent a direct line to Heap.