Mixpanel MCP Server

A Model Context Protocol (MCP) server for integrating Mixpanel analytics into AI workflows. This server allows AI assistants like Claude to track events, page views, user signups, and update user profiles in Mixpanel.

Version 2.0.1 Note: Tool names now include the mixpanel_ prefix to prevent namespace collisions with other analytics MCP servers.

Table of Contents

• Features
• Installation
• Quick Start
• Detailed Usage
  • With Claude Desktop
  • With Other MCP Clients
• Tool Reference
• Examples
• Troubleshooting
• Security Notes
• Contributing
• License

Features

• Track custom events in Mixpanel
• Track page views with referrer information
• Track user signups and create user profiles
• Update existing user profiles
• Simple integration with Claude Desktop and other MCP clients

Installation

Prerequisites

• Node.js 16 or higher
• A Mixpanel project token (get one by signing up at Mixpanel)

NPM Installation (Recommended)

# Install globally
npm install -g mixpanel-mcp-server

# Or use directly with npx
npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

Manual Installation

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

# Install dependencies
npm install

# Run the server
node index.js --token YOUR_MIXPANEL_TOKEN

Quick Start

To start using the Mixpanel MCP server with Claude Desktop:

1. Make sure Claude Desktop is installed on your machine (download from claude.ai/download)

2. Create or edit the Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %AppData%\Claude\claude_desktop_config.json

3. Add the Mixpanel MCP server configuration:

{
  "mcpServers": {
    "mixpanel-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "mixpanel-mcp-server",
        "--token",
        "YOUR_MIXPANEL_TOKEN"
      ]
    }
  }
}

4. Restart Claude Desktop and start tracking analytics!

Detailed Usage

With Claude Desktop

After setting up the configuration file as shown in the Quick Start section, you can use the Mixpanel analytics capabilities directly in your conversations with Claude.

Examples of prompts you can use:

• “Track a custom event in Mixpanel named ‘document_generated’ for user ‘user123’”
• “Track a page view for the homepage in Mixpanel”
• “Create a new user profile in Mixpanel for John Doe with email [email protected]”
• “Update user profile information in Mixpanel for user ‘user123’”

Claude will use the appropriate Mixpanel MCP tool based on your request.