Connect Heap to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the manage user properties tool in Heap
Use the manage account properties tool in Heap
Use the track event tool in Heap
Use the identify user tool in Heap
Use the delete user tool in Heap
Use the get deletion status tool in Heap
Supported Tools
manage_user_properties
Manage User Properties
Attach custom properties to user profiles in Heap. Supports both single user and bulk updates (up to 1000 users per request).
Use this to enrich user profiles with data from your database, demographic info, or other attributes not automatically captured by Heap.
Properties can be set without an existing session, making this ideal for backfilling historical data.
manage_account_properties
Manage Account Properties
Attach custom properties to accounts in Heap for B2B analytics. Supports both single account and bulk updates (up to 1000 accounts per request).
Use this to associate attributes like company name, plan tier, industry, or revenue potential with groups of users.
Requires Account ID to be configured in your Heap project settings before use.
track_event
Track Event
Send custom server-side events to Heap. Supports both single event tracking and bulk event ingestion (up to 1000 events per request).
Use this for events that need to exactly match your backend data, such as completed transactions, or events not available for client-side capture.
identify_user
Identify User
Link an anonymous Heap user ID to a known identity (e.g., email address), merging their activity history into a single user profile.
This enables cross-session, cross-device, and cross-browser user tracking under one unified profile.
delete_user
Delete User
Submit a user or batch of users for deletion from all environments in your Heap account.
Returns a deletion request ID and status. Deletion is asynchronous; call get_deletion_status until the request is complete.
get_deletion_status
Get Deletion Status
Check whether a user deletion request submitted with delete_user is pending or complete.
Enable Heap in Metorial. In your Metorial portal, enable the Heap MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Heap tools.
Enable Heap in Metorial. In your Metorial portal, enable the Heap MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Heap tools.
Enable Heap in Metorial. In your Metorial portal, enable the Heap MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Heap tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Heap in Metorial. In your Metorial portal, enable the Heap MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Heap tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Heap in Metorial. In your Metorial portal, enable the Heap MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Heap tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Heap through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Heap and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Heap tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Track custom events, link anonymous users to known identities, and enrich user and account profiles. Supports single and bulk ingestion, asynchronous privacy deletion requests, and deletion status checks.
Frequently asked questions
Common questions about connecting Heap to AI agents with Metorial.
How many tools does the Heap MCP server have?
The Heap MCP server exposes 6 tools, including Manage User Properties, Manage Account Properties, Track Event. Each one is governed and traced through Metorial.
Does the Heap MCP server support triggers?
Heap exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Heap MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Heap MCP server through the same Metorial URL.
How do I give only some teams access to Heap?
Use role-based access control to decide which teams, users, and agents can use Heap and which of its tools they can call.
Can I self-host the Heap MCP server?
Yes. Metorial is open source, so you can run the Heap MCP server yourself or use the hosted gateway.
Connect Heap to production AI agents
See how Metorial gives your team governed access to Heap, with tracing and security controls built in.