Home / MCP / Mixpanel MCP Server

Mixpanel MCP Server

Queries Mixpanel events, retention, and funnels via MCP clients using a service account.

javascript

19stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "mixpanel_mcp": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/mixpanel-mcp/build/index.js",
                "YOUR_SERVICE_ACCOUNT_USERNAME",
                "YOUR_SERVICE_ACCOUNT_PASSWORD",
                "YOUR_PROJECT_ID"
            ]
        }
    }
}

Mixpanel MCP is a server you run to talk to the Mixpanel API from any MCP client. It lets you ask questions about your events data, retention, and funnels directly from your preferred MCP interface, making on-demand lookups and data exploration straightforward.

How to use

Connect to Mixpanel data from your MCP client to query events, retention, and funnels. You can perform on-demand lookups like: "What’s the weekly retention for users in the Feb 1 cohort?" or get an overview of events to understand how users interact with your product. Use the MCP client of your choice (Cursor, Claude Desktop, etc.) to run queries against Mixpanel through the MCP server.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine. You also need a Mixpanel Service Account with a username, password, and a project ID from your Mixpanel Organization settings.

Install for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dragonkhoi/mixpanel-mcp --client claude

Install for Cursor by adding an MCP server through Cursor settings. Copy and paste the following command into the MCP Server configuration in Cursor, replacing the credential placeholders with your Mixpanel service account details.

npx -y @smithery/cli@latest run @dragonkhoi/mixpanel-mcp --config "{\"username\":\"YOUR_SERVICE_ACCT_USERNAME\",\"password\":\"YOUR_SERVICE_ACCT_PASSWORD\",\"projectId\":\"YOUR_MIXPANEL_PROJECT_ID\"}"

Clone and run locally

If you prefer to run the server locally, clone the project and run it with your Mixpanel service account credentials.

# Clone the repository
 git clone https://github.com/dragonkhoi/mixpanel-mcp.git
 cd mixpanel-mcp

# Build the project
 npm install
 npm run build

# Run the MCP server locally (provide your credentials as arguments)
 node /ABSOLUTE/PATH/TO/mixpanel-mcp/build/index.js YOUR_SERVICE_ACCOUNT_USERNAME YOUR_SERVICE_ACCOUNT_PASSWORD YOUR_PROJECT_ID

Notes and requirements

Make sure your Mixpanel service account credentials are correct and that the project ID matches your Mixpanel project. The MCP server uses these credentials to access your events data, retention data, and funnels.

Available tools

Query events data

Retrieve and analyze events data from your Mixpanel project to understand user interactions, event counts, and event properties.

Query retention

Calculate retention metrics over specified cohorts and time windows to gauge user engagement over time.

Query funnels

Access funnel data to see conversion paths and drop-off points across stages of user journeys.