Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Heap in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.
Summary
Send events, identify users and update properties in Heap (product analytics) from any AI agent. 5 tools, app_id-based auth.
Try asking
Example prompts for Heap
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Heap, paste your credentials, mint an MCP API key — done. No Docker, no
git clone, no local server.
Heap + Claude
Send events, identify users and update properties in Heap (product analytics) from any AI agent. 5 tools, app_id-based auth.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
HEAP_APP_ID
Step 1 — Get credentials
Setup:
- Sign in to https://app.heap.io → top-right → Account → Projects → select project → Project ID (called
app_id). - Set
HEAP_APP_IDto the numeric app/project ID.
Authentication: NONE — Heap's server-side API uses the app_id in the request body to route events to your project. There's no secret on the ingestion endpoint (anyone with your app_id can fake events — same trust model as Google Analytics client-side JS).
…(continued in the in-app connector instructions)
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Claude
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Recommended path — works on claude.ai web without editing any config file.
- In Claude, open Customize → Connectors.
- Click +, then Add custom connector.
- Enter a name, e.g.
Heap, and the remote MCP server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Add. - Click Connect and sign in to AnythingMCP (OAuth) to allow access.
All tools below appear in your chat — start typing prompts.
Available tools
| Tool | What it does |
|---|---|
heap_track_event | Track a single behavioral event for a user |
heap_bulk_track | Bulk-track many events in one call (up to 1000 events, 1MB total) |
heap_add_user_properties | Set or update user-level properties (Heap merges with existing) |
heap_add_account_properties | Set or update properties on an account (B2B model — accounts group users) |
heap_add_user_to_account | Associate a user (identity) with an account (account_id) |
FAQ
Does it work with Claude Code as well as Claude Desktop? Yes — point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Next steps
Was this guide helpful?
