Mixpanel MCP Integration

Overview

The Mixpanel Model Context Protocol (MCP) integration enables organizations to analyze product data using conversational AI. Teams can query events, funnels, and user behavior through AI interfaces (Claude, Cursor, etc.) using natural language, eliminating the need for complex dashboard navigation or technical query languages.

Beta Feature: Help us improve this integration by sharing your feedback here.

Mixpanel MCP Tools

The MCP integration provides access to all core Mixpanel analysis capabilities through natural language queries:

Analytics Functions

Segmentation: Event counts and unique users with filtering and grouping (run_segmentation_query)
Funnels: Conversion rate analysis across user journeys (run_funnels_query)
Retention: User engagement and return behavior tracking (run_retention_query)
Frequency: User engagement patterns and usage intensity (run_frequency_query)

Data Discovery & Exploration

Project Management: Access projects and workspace information (get_projects, get_project_info)
Event Discovery: Browse all available events in your project (get_events)
Event Properties: Explore properties available for each event (get_event_properties)
Property Values: Discover specific values for event properties (get_event_property_values)
Data Quality: Monitor and detect volume anomalies in data ingestion (get_data_volume_anomalies)
Lexicon Integration: Get direct links to event definitions and documentation in Mixpanel Lexicon (get_lexicon_detail_url)

Query Capabilities

Natural Language Filtering: Use complex boolean expressions for data filtering
Advanced Grouping: Segment data by properties with mathematical operations
Time-based Analysis: Analyze trends across different time periods (hourly, daily, weekly, monthly)
Numerical Aggregations: Perform sum, average, and bucket analysis on numeric properties

For more information on organizing and documenting your events, see Mixpanel Lexicon documentation.

Getting Started

Beta Access

The Mixpanel MCP integration is currently in Beta. You can start using it right away by following the Implementation Guide below.

Permissions & Access Control

Admin Configuration Required

Organization administrators must enable MCP access in Settings > Org > Overview
Once enabled by an admin, all Mixpanel users in the organization can use the MCP integration
The MCP toggle controls access for the entire organization

User Access Scope After the organization admin enables MCP:

Any Mixpanel user with any role can connect to the MCP integration
Users can only query data from projects they already have access to within Mixpanel
Existing Mixpanel permissions and project access controls remain in effect

Recommended Implementation Path

Organization admin enables “Enable MCP” toggle in organization settings
Individual users complete the integration setup following the Implementation Guide
Users authenticate with their Mixpanel account during the connection process
Once authenticated, start by asking: “What Mixpanel projects do I have access to?”
Select a project from the response to focus your analysis
Ask any questions about your Mixpanel data—refer to Use Case Examples below if you need ideas
Begin with test data to validate functionality
Conduct security review before production data access
Train teams on natural language query techniques
Expand usage across product and analytics teams

Implementation Guide

Prerequisites (for Claude Free & Cursor)

Install Node.js (if needed):

brew install node

Option 1: Claude Pro

Setup Steps:

Navigate to claude.ai or open Claude desktop app
Go to Settings → Connectors → Add Custom Connector
Configure the integration:
- Integration Name: Mixpanel (or preferred name)
- Integration URL: https://mcp.mixpanel.com/sse
Click Connect and complete Mixpanel authorization

For additional information on setting up Claude connectors, see Claude’s connector documentation.

Option 2: Claude Free

Additional Requirements:

Claude desktop application
Command line access

Setup Steps:

Open Claude desktop app
Navigate to Settings (from window nav bar) → Developer → Edit Config
Add the following configuration:

{
  "mcpServers": {
    "mixpanel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mixpanel.com/sse",
        "--allow-http"
      ]
    }
  }
}

Run authorization command in terminal:

npx -y mcp-remote https://mcp.mixpanel.com/sse --allow-http

Complete Mixpanel authorization via the provided link

Option 3: Cursor

Additional Requirements:

Cursor application
Command line access

Setup Steps:

Open Cursor application
Navigate to Cursor Settings → MCP & Integrations → MCP Tools → New MCP Server
This opens MCP.json where you paste the following configuration:

{
  "mcpServers": {
    "mixpanel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mixpanel.com/sse",
        "--allow-http"
      ]
    }
  }
}

Run authorization command in terminal:

npx -y mcp-remote https://mcp.mixpanel.com/sse --allow-http

Complete Mixpanel authorization via the provided link

Use Case Examples

Channel Performance Analysis

Query example: “Which channels drive the most users?”
Business Value: Identify top-performing acquisition channels for budget allocation

Retention Intelligence

Query: “Which channels drive users who retain best?”
Business Value: Understand quality vs. quantity in user acquisition strategy

Conversion Optimization

Query: “Show me signup conversion rates by source”
Business Value: Optimize funnel performance by traffic source

User Journey Analysis

Query: “What’s the typical user journey for power users?”
Business Value: Identify patterns in high-value user behavior for product development

Advanced Analytics

Query: “Compare user behavior across different feature roll outs”
Business Value: Measure feature impact and optimize product decisions

Key Benefits

Democratized Analytics

Natural language queries eliminate technical barriers
Instant insights without dashboard complexity
Accessible to non-technical stakeholders

Enhanced Productivity

Reduce time-to-insight from minutes to seconds
Eliminate context switching between tools
Enable real-time decision making

Strategic Value

Accelerate product discovery processes
Enable data-driven conversations across teams
Improve accessibility of product intelligence

Security & Compliance Considerations

Data Handling Important: This integration enables querying your Mixpanel data through AI services (Claude, Cursor, etc.). Review your organization’s data handling policies before implementation.

Access Controls

Organization administrators must enable MCP in Settings > Org > Overview
Users can only query data from projects they already have access to within Mixpanel
Existing Mixpanel permissions and project access controls remain in effect

Best Practices

Start with demo or test datasets
Conduct internal security review before production use
Consider compliance requirements (GDPR, CCPA, etc.)
Establish usage guidelines for teams
Monitor data sharing patterns

Technical Specifications

Supported Platforms

Claude Pro: Web interface with native MCP support
Claude Free: Desktop app with configuration setup
Cursor: AI-powered code editor integration

Integration Architecture

Protocol: Model Context Protocol (MCP)
Connection: Server-sent events (SSE)
Authentication: OAuth with Mixpanel
Endpoint: https://mcp.mixpanel.com/sse

Troubleshooting

Common Issues

Node.js not found: Install using brew install node
Authorization fails: Ensure proper Mixpanel account permissions
Desktop app issues: Restart application after configuration changes
Free user limitations: Remote URL integrations only supported in desktop app

Custom Properties Saved Metrics & Behaviors

Was this page useful?