Mixpanel Server

npm version License: MIT

An MCP (Model Context Protocol) server that wraps the Mixpanel REST API. Query events, funnels, retention, user profiles, and more — directly from any MCP-compatible AI agent.

Quick Start

npm install -g @t-campbell18/mcp-mixpanel

Set the required environment variables and run:

export MIXPANEL_PROJECT_ID="your-project-id"
export MIXPANEL_SERVICE_ACCOUNT_USERNAME="your-username"
export MIXPANEL_SERVICE_ACCOUNT_PASSWORD="your-password"
mcp-mixpanel

Environment Variables

Variable	Required	Description
MIXPANEL_PROJECT_ID	Yes	Your Mixpanel project ID
MIXPANEL_SERVICE_ACCOUNT_USERNAME	One auth method	Service account username
MIXPANEL_SERVICE_ACCOUNT_PASSWORD	One auth method	Service account password
MIXPANEL_API_SECRET	One auth method	Project API secret (legacy)
MIXPANEL_REGION	No	US (default) or EU

Authentication

At least one authentication method is required:

1. Service Account (recommended): Set both MIXPANEL_SERVICE_ACCOUNT_USERNAME and MIXPANEL_SERVICE_ACCOUNT_PASSWORD. Service accounts support all query and export endpoints.
2. API Secret (legacy): Set MIXPANEL_API_SECRET. Falls back to this if no service account is configured.

Tools

Query API

Tool	Description	Example Prompt
query_events	Query event data with segmentation	"How many signups happened last week?"
top_events	Get the most common events	"What are the top events today?"
event_properties	Get top properties for an event	"What properties does the Purchase event have?"
query_funnels	Query a saved funnel	"Show me conversion for funnel 12345"
list_funnels	List all saved funnels	"What funnels do we have?"
query_retention	Query retention data	"What's our 7-day retention for signups?"
frequency_report	Get frequency/addiction report	"How often do users perform the Search event?"
query_profiles	Query user profiles	"Find users who were last seen after Jan 1"
user_activity	Get a user's event stream	"Show me recent activity for user abc123"
query_insights	Run a saved Insights report	"Run insights report 67890"
run_jql	Run a JQL script	"Run this JQL to find power users"
segmentation_sum	Sum a numeric property over time	"What's total revenue this month?"
segmentation_average	Average a numeric property over time	"What's the average order value this week?"
list_cohorts	List all cohorts	"What cohorts do we have?"

Export API

Tool	Description	Example Prompt
export_events	Export raw event data (NDJSON, max 5000)	"Export all Purchase events from last week"

Annotations

Tool	Description	Example Prompt
list_annotations	List annotations in a date range	"Show annotations from this month"

Setup

Claude Code

claude mcp add mixpanel -- npx -y @t-campbell18/mcp-mixpanel

Set environment variables in your shell before running Claude Code.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mixpanel": {
      "command": "npx",
      "args": ["-y", "@t-campbell18/mcp-mixpanel"],
      "env": {
        "MIXPANEL_PROJECT_ID": "your-project-id",
        "MIXPANEL_SERVICE_ACCOUNT_USERNAME": "your-username",
        "MIXPANEL_SERVICE_ACCOUNT_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "mixpanel": {
      "command": "npx",
      "args": ["-y", "@t-campbell18/mcp-mixpanel"],
      "env": {
        "MIXPANEL_PROJECT_ID": "your-project-id",
        "MIXPANEL_SERVICE_ACCOUNT_USERNAME": "your-username",
        "MIXPANEL_SERVICE_ACCOUNT_PASSWORD": "your-password"
      }
    }
  }
}

VS Code

Add to your VS Code MCP settings (.vscode/mcp.json):

{
  "servers": {
    "mixpanel": {
      "command": "npx",
      "args": ["-y", "@t-campbell18/mcp-mixpanel"],
      "env": {
        "MIXPANEL_PROJECT_ID": "your-project-id",
        "MIXPANEL_SERVICE_ACCOUNT_USERNAME": "your-username",
        "MIXPANEL_SERVICE_ACCOUNT_PASSWORD": "your-password"
      }
    }
  }
}

OpenClaw

mcp_servers:
  - name: mixpanel
    command: npx
    args: ["-y", "@t-campbell18/mcp-mixpanel"]
    env:
      MIXPANEL_PROJECT_ID: "your-project-id"
      MIXPANEL_SERVICE_ACCOUNT_USERNAME: "your-username"
      MIXPANEL_SERVICE_ACCOUNT_PASSWORD: "your-password"

EU Region

If your Mixpanel project is in the EU data residency, set:

export MIXPANEL_REGION=EU

This routes all API calls to Mixpanel's EU endpoints automatically.

License

MIT