heap-mcp.md

Heap Analytics MCP

from"rivit-studio"

Community MCP server for sending Heap events, enriching user and account profiles, resolving identities, and handling GDPR deletion requests

Source and setup verified on 2026-08-31

Data & Analytics
Heap Analyticseventsuser profilesGDPR

What you can do

  • Send individual or bulk events to Heap Analytics
  • Add user and account properties for richer profiles
  • Resolve identities across anonymous and known users
  • Submit and monitor GDPR user-deletion requests

Requirements

  • Node.js 18 or newer
  • A Heap environment (app) ID
  • A Heap API key for deletion tools
  • An MCP-compatible client
setup.md
# 1. Run with npx
$HEAP_APP_ID=your_app_id npx heap-mcp-server

Fastest local STDIO setup when the npm package is available.

# 2. Clone the maintained source
$git clone https://github.com/rivit-studio/heap-mcp-server.git
# 3. Install and build
$cd heap-mcp-server && npm install && npm run build
# 4. Start the server
$HEAP_APP_ID=your_app_id node dist/index.js

Add HEAP_API_KEY only when using the deletion tools.

Always confirm the latest setup instructions with the maintainer before installing.