Provides comprehensive access to Mixpanel analytics data, enabling retrieval and analysis of event analytics, user profiles, retention patterns, conversion funnels, and custom queries using JQL (JSON Query Language).
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 eu
or-r eu
to your commands!
📦 Quick Start
⚡ Using npx (Recommended)
The fastest way to get started - no installation required!
🎯 Try it now: Run npx @mendeel/mcp-mixpanel --help
to see all options!
🔧 Command Line Options
🔑 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.comEU Region: Use
-r eu
for eu.mixpanel.comIf you access Mixpanel at eu.mixpanel.com, you MUST use
-r eu
🚀 Using Your Credentials
Method 1: Command Line (Quick testing)
Method 2: Environment Variables (Recommended)
🛠️ 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:
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:
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:
Method 2: Workspace Configuration
Create a .cursorrules
file in your project root:
Claude Desktop Integration
Add to your Claude Desktop configuration (~/.config/Claude/claude_desktop_config.json
):
Or with environment variables:
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:
🎯 Usage Examples
Getting Today's Top Events
Ask your AI assistant:
The AI can now access real-time event data and identify trending activities.
Analyzing User Behavior
Ask your AI assistant:
The AI can retrieve detailed user journey data and analyze behavior patterns.
Retention Analysis
Ask your AI assistant:
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
🐛 Troubleshooting
Common Issues
"Authentication failed" errors:
"Command not found" errors:
"Project not found" errors:
Network/proxy issues:
Editor not recognizing MCP server:
Debug Mode
Enable verbose logging:
📄 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!
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A server that interfaces with the Mixpanel API, allowing users to query events data, retention, and funnels through natural language from any MCP client like Cursor or Claude Desktop.
Related MCP Servers
- -securityFlicense-qualityThis is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.Last updated -
- AsecurityAlicenseAqualityConnect to your Mixpanel data. Query events, retention, and funnel data from Mixpanel analytics.Last updated -1917MIT License
- -securityFlicense-qualityA server that connects MCP clients (Claude, Cursor, Windsurf, etc.) to EventCatalog instances, allowing users to ask questions about their event-driven architecture and get insights about domains, services, and message schemas directly within their development tools.Last updated -616
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with Mixpanel analytics, allowing them to track events, page views, user signups, and update user profiles directly through natural language requests.Last updated -185MIT License