Mixpanel MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to Mixpanel analytics data. This server enables AI tools like Claude Desktop, Continue.dev, VS Code, Cursor, and other MCP-compatible clients to retrieve and work with Mixpanel data seamlessly.
🚀 Key Features
- Event Analytics: Get today's top events, event counts, and event properties
- User Profiles: Query user profiles and analyze individual user journeys
- Retention Analysis: Analyze user retention patterns and cohort behavior
- Funnel Analysis: Retrieve and analyze conversion funnels
- Segmentation: Segment events and users by properties
- Custom Queries: Run custom JQL (JSON Query Language) scripts
- Multi-Region Support: Works with both US and EU Mixpanel instances
🌍 Important: If you use eu.mixpanel.com, make sure to add
--region euor-r euto your commands!
📦 Quick Start
⚡ Using npx (Recommended)
The fastest way to get started - no installation required!
# Basic usage with required credentials
npx @mendeel/mcp-mixpanel --username YOUR_USERNAME --password YOUR_PASSWORD --project-id YOUR_PROJECT_ID
# Short form
npx @mendeel/mcp-mixpanel -u YOUR_USERNAME -p YOUR_PASSWORD -i YOUR_PROJECT_ID
# EU region
npx @mendeel/mcp-mixpanel -u YOUR_USERNAME -p YOUR_PASSWORD -i YOUR_PROJECT_ID -r eu
# Using environment variables
export MIXPANEL_SERVICE_ACCOUNT_USERNAME=your_username
export MIXPANEL_SERVICE_ACCOUNT_PASSWORD=your_password
export MIXPANEL_PROJECT_ID=your_project_id
npx @mendeel/mcp-mixpanel
🎯 Try it now: Run npx @mendeel/mcp-mixpanel --help to see all options!
🔧 Command Line Options
mcp-mixpanel [options]
Options:
--username, -u <username> Mixpanel service account username
--password, -p <password> Mixpanel service account password
--project-id, -i <project_id> Default Mixpanel project ID
--region, -r <region> Mixpanel region (us or eu) - default: us
--help, -h Show help message
--version, -v Show version information
Environment Variables:
MIXPANEL_SERVICE_ACCOUNT_USERNAME Mixpanel service account username
MIXPANEL_SERVICE_ACCOUNT_PASSWORD Mixpanel service account password
MIXPANEL_PROJECT_ID Default Mixpanel project ID
MIXPANEL_REGION Mixpanel region (us or eu) - default: us
Examples:
npx @mendeel/mcp-mixpanel --help
npx @mendeel/mcp-mixpanel --version
npx @mendeel/mcp-mixpanel -u myuser -p mypass -i 12345
npx @mendeel/mcp-mixpanel -u myuser -p mypass -i 12345 -r eu
MIXPANEL_PROJECT_ID=12345 npx @mendeel/mcp-mixpanel -u myuser -p mypass -r us
🔑 Mixpanel Setup
📝 Getting Your Credentials (2 minutes)
-
Go to Mixpanel Organization Settings:
- Visit your Mixpanel dashboard
- Go to Organization Settings → Service Accounts
-
Create Service Account:
- Click "Create Service Account"
- Give it a name like "MCP Server"
- Copy the username and password - you won't see them again!
-
Get Your Project ID:
- Go to Project Settings
- Copy your Project ID from the project information
-
Note Your Region:
- US Region: Use
-r us(default) for mixpanel.com - EU Region: Use
-r eufor eu.mixpanel.com - If you access Mixpanel at eu.mixpanel.com, you MUST use
-r eu
- US Region: Use
🚀 Using Your Credentials
Method 1: Command Line (Quick testing)
# US region (default)
npx @mendeel/mcp-mixpanel --username your_username --password your_password --project-id your_project_id
# EU region (if you use eu.mixpanel.com)
npx @mendeel/mcp-mixpanel --username your_username --password your_password --project-id your_project_id --region eu
Method 2: Environment Variables (Recommended)
# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
export MIXPANEL_SERVICE_ACCOUNT_USERNAME=your_username
export MIXPANEL_SERVICE_ACCOUNT_PASSWORD=your_password
export MIXPANEL_PROJECT_ID=your_project_id
export MIXPANEL_REGION=us # or 'eu' for EU region
# Then simply run:
npx @mendeel/mcp-mixpanel
🛠️ Editor Integration
VS Code Integration
Method 1: Using Continue Extension
-
Install Continue Extension:
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Search for "Continue" and install it
-
Configure MCP Server:
- Open Command Palette (Ctrl+Shift+P)
- Type "Continue: Configure" and select it
- Add this configuration to your settings:
{
"continue.server": {
"mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["@mendeel/mcp-mixpanel", "--username", "your_username", "--password", "your_password", "--project-id", "your_project_id", "--region", "us"]
}
}
}
}
Method 2: Using Claude Extension
-
Install Claude Extension:
- Search for "Claude" in VS Code extensions
- Install the official Claude extension
-
Configure MCP Server:
- Add to your VS Code settings.json:
{
"claude.mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["@mendeel/mcp-mixpanel"],
"env": {
"MIXPANEL_SERVICE_ACCOUNT_USERNAME": "your_username",
"MIXPANEL_SERVICE_ACCOUNT_PASSWORD": "your_password",
"MIXPANEL_PROJECT_ID": "your_project_id",
"MIXPANEL_REGION": "us"
}
}
}
}
Cursor Integration
Method 1: Global Configuration
-
Open Cursor Settings:
- Go to Settings (Cmd/Ctrl + ,)
- Search for "MCP" or "Model Context Protocol"
-
Add MCP Server Configuration:
{
"mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["@mendeel/mcp-mixpanel", "--username", "your_username", "--password", "your_password", "--project-id", "your_project_id"]
}
}
}
Method 2: Workspace Configuration
Create a .cursorrules file in your project root:
{
"mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["@mendeel/mcp-mixpanel"],
"env": {
"MIXPANEL_SERVICE_ACCOUNT_USERNAME": "your_username",
"MIXPANEL_SERVICE_ACCOUNT_PASSWORD": "your_password",
"MIXPANEL_PROJECT_ID": "your_project_id",
"MIXPANEL_REGION": "us"
}
}
}
}
Claude Desktop Integration
Add to your Claude Desktop configuration (~/.config/Claude/claude_desktop_config.json):
{
"mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["@mendeel/mcp-mixpanel", "--username", "your_username", "--password", "your_password", "--project-id", "your_project_id"]
}
}
}
Or with environment variables:
{
"mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["@mendeel/mcp-mixpanel"],
"env": {
"MIXPANEL_SERVICE_ACCOUNT_USERNAME": "your_username",
"MIXPANEL_SERVICE_ACCOUNT_PASSWORD": "your_password",
"MIXPANEL_PROJECT_ID": "your_project_id",
"MIXPANEL_REGION": "us"
}
}
}
}
Continue.dev Integration
-
Install Continue.dev:
- Download from continue.dev
- Install the application
-
Configure MCP Server:
- Open Continue.dev
- Go to Settings → MCP Servers
- Add new server:
{
"name": "mixpanel",
"command": "npx",
"args": ["@mendeel/mcp-mixpanel", "--username", "your_username", "--password", "your_password", "--project-id", "your_project_id"]
}
🎯 Usage Examples
Getting Today's Top Events
Ask your AI assistant:
"Show me today's top events from Mixpanel"
The AI can now access real-time event data and identify trending activities.
Analyzing User Behavior
Ask your AI assistant:
"Get the event activity for user ID 12345 from last week"
The AI can retrieve detailed user journey data and analyze behavior patterns.
Retention Analysis
Ask your AI assistant:
"What's the 7-day retention for users who signed up in January?"
The AI can generate retention reports and provide insights on user engagement.
🛠️ Available Tools
The MCP server provides these tools for AI assistants:
Event Tools
get_today_top_events- Get today's most active eventsget_top_events- Get top events over the last 31 daysaggregate_event_counts- Get event counts over time periodsaggregated_event_property_values- Analyze specific event properties
User Profile Tools
profile_event_activity- Get individual user event activityquery_profiles- Query user profiles with filtering
Analytics Tools
query_retention_report- Analyze user retentionquery_funnel_report- Get funnel conversion datalist_saved_funnels- List available funnelslist_saved_cohorts- List user cohorts
Advanced Tools
custom_jql- Run custom JQL queriesquery_segmentation_report- Segment events by propertiesquery_insights_report- Get saved insights reports
Example Tool Usage
// These tools can be called by AI assistants via MCP protocol
// Get today's top events
{
"tool": "get_today_top_events",
"arguments": { "limit": 5 }
}
// Get user activity
{
"tool": "profile_event_activity",
"arguments": {
"distinct_ids": "[\"user123\"]",
"from_date": "2024-01-01",
"to_date": "2024-01-07"
}
}
// Analyze retention
{
"tool": "query_retention_report",
"arguments": {
"from_date": "2024-01-01",
"to_date": "2024-01-31",
"born_event": "sign_up"
}
}
🐛 Troubleshooting
Common Issues
"Authentication failed" errors:
# Solution: Check your service account credentials
npx @mendeel/mcp-mixpanel --username your_username --password your_password --project-id your_project_id
"Command not found" errors:
# Solution: Install Node.js 18+ and ensure npx is available
node --version # Should be 18+
npx --version # Should work
"Project not found" errors:
# Check your project ID in Mixpanel Project Settings
# Make sure the service account has access to the project
Network/proxy issues:
# Set proxy if needed
export HTTP_PROXY=http://your-proxy:8080
export HTTPS_PROXY=http://your-proxy:8080
npx mcp-mixpanel
Editor not recognizing MCP server:
# Verify the server is running
npx @mendeel/mcp-mixpanel --help
# Check your editor's MCP configuration
# Ensure the command and args are correct
Debug Mode
Enable verbose logging:
# Set debug environment variable
DEBUG=* npx @mendeel/mcp-mixpanel --username your_username --password your_password --project-id your_project_id
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🤝 Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📞 Support
🔗 Related Projects
- Mixpanel - The analytics platform this server provides access to
- Model Context Protocol - The protocol specification
- MCP TypeScript SDK - Official MCP SDK
⭐ Acknowledgments
- Mixpanel for the powerful analytics platform
- Anthropic for the Model Context Protocol specification
- The open source community for inspiration and contributions
Made with ❤️ for the MCP community
Star ⭐ this repo if you find it helpful!