heap-mcp.md

Heap Analytics MCP

MCP server

from"rivit-studio"

heap-mcp-server is a community project by rivit-studio, not made by Heap. It exposes Heap's server-side API as eight MCP tools, so an agent can send events, add user and account properties, merge identities and process deletion requests.

Not for: Reading analytics. This server only writes to Heap; it cannot query dashboards, funnels or reports. The maintainer points to Heap Connect and your data warehouse for that.

Source and setup verified on 2026-11-03

Data & Analytics

Heap Analyticseventsuser profilesGDPR

View on GitHub

Quick facts

Maintainer: rivit-studio (community)
Tools: 8, all write or delete except one status check
Transport: stdio (default) or HTTP
Install: Build from source. Not published to npm as of 2026-11-03
UI: None (tools only)

What you can do

heap_track_event and heap_bulk_track_events (up to 1,000 events per call)
heap_add_user_properties and its bulk version
heap_add_account_properties, single or bulk
heap_identify_user to merge anonymous and known users
heap_delete_users (up to 10,000 users) and heap_get_deletion_status

Requirements

Node.js 18 or newer
Heap environment ID: Account › Manage › Projects
Heap API key, only for the deletion tools: Account › Manage › Privacy & Security
HEAP_DATA_CENTER=eu if your Heap account is in the EU

setup.md

# 1. Clone the repository

$git clone https://github.com/rivit-studio/heap-mcp-server.git

# 2. Install and build

$cd heap-mcp-server && npm install && npm run build

# 3. Register it with your client

Point the client at dist/index.js and pass your environment ID, as in the config below.

# Claude Desktop → claude_desktop_config.json

{
  "mcpServers": {
    "heap": {
      "command": "node",
      "args": ["/absolute/path/to/heap-mcp-server/dist/index.js"],
      "env": {
        "HEAP_APP_ID": "your_environment_id"
      }
    }
  }
}

Add HEAP_API_KEY only if you need deletions. For deletions, HEAP_APP_ID must be your Main Production environment.

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

>Questions

Is this an official Heap MCP server?

No. It is maintained by rivit-studio. Heap has not published its own MCP server.

Can it answer questions about my Heap data?

No. Every tool writes to Heap or checks a deletion request. To analyse Heap data with an LLM, export it with Heap Connect and use a database MCP server on the warehouse.