Mixpanel MCP Server
Official Mixpanel MCP server for querying events, funnels, flows, retention, session replays, dashboards, and experiments via natural language.
The Mixpanel MCP server is the official, provider-hosted Model Context Protocol endpoint that lets AI assistants like Claude, Cursor, ChatGPT, Gemini, and Notion query Mixpanel project data using natural language. Rather than building dashboards or writing report definitions by hand, users can ask product analytics questions and get answers backed by their actual events, properties, cohorts, and saved reports. The server supports both read and write operations, meaning agents can not only run insights, funnels, flows, and retention analyses but also create and edit dashboards, manage lexicon entries, dismiss issues, and configure experiments and feature flags.
Authentication is handled via OAuth 2.0 (Authorization Code + PKCE/S256), so users sign in with their Mixpanel credentials and inherit their existing project permissions. The server is regionally hosted (US, EU, IN), enforces a 600 requests/hour-per-user rate limit, and must be explicitly enabled by an organization administrator before it can be used. Session replay data is exposed alongside event data through a dedicated tool, making it possible to combine quantitative analysis with replay context in a single agent workflow.
Notable capabilities include a unified Run-Query tool that handles insights, funnels, flows, and retention through a single JSON schema (discoverable via Get-Query-Schema), full dashboard CRUD, and beta tools for managing experiments and feature flags. Because the server is hosted by Mixpanel, there is no code to deploy or maintain: clients simply point at the regional URL and complete the OAuth flow.
Tools
| Tool | Description |
|---|---|
Run-Query |
Execute insights, funnels, flows, and retention analyses using a unified query schema. |
Get-Query-Schema |
Retrieve the full JSON schema needed to construct Run-Query payloads. |
Get-Report |
Fetch a saved Mixpanel report, optionally with current results. |
Get-User-Replays-Data |
Return session replay data joined with event data for a given user. |
Create-Dashboard |
Create a new dashboard in a Mixpanel project. |
List-Dashboards |
List dashboards available in a project. |
Get-Dashboard |
Retrieve a dashboard and its contents. |
Update-Dashboard |
Modify an existing dashboard. |
Duplicate-Dashboard |
Clone an existing dashboard. |
Delete-Dashboard |
Delete a dashboard. |
Get-Projects |
List Mixpanel projects the authenticated user can access. |
Get-Events |
List event names tracked in a project. |
Get-Property-Names |
List property names for events in a project. |
Get-Property-Values |
List observed values for a given property. |
Get-Event-Details |
Retrieve detailed metadata about a specific event. |
Get-Issues |
Fetch governance issues (e.g. duplicate, deprecated entries). |
Get-Lexicon-URL |
Return a URL to the Lexicon UI for the project. |
Edit-Event |
Update lexicon metadata for an event (description, tags, visibility). |
Edit-Property |
Update lexicon metadata for a property. |
Create-Tag |
Create a lexicon tag. |
Rename-Tag |
Rename an existing lexicon tag. |
Delete-Tag |
Delete a lexicon tag. |
Dismiss-Issues |
Mark governance issues as dismissed. |
List-Experiments |
List experiments in a project (beta). |
Get-Experiment |
Fetch a single experiment (beta). |
Create-Experiment |
Create a new experiment (beta). |
Update-Experiment |
Update an existing experiment (beta). |
List-Feature-Flags |
List feature flags in a project (beta). |
Get-Feature-Flag |
Retrieve a single feature flag (beta). |
Create-Feature-Flag |
Create a feature flag (beta). |
Update-Feature-Flag |
Update a feature flag (beta). |
Prerequisites
- A Mixpanel account with access to one or more projects
- An organization admin must enable MCP in Settings → Organization → Overview (changes take ~15 minutes to propagate)
- Node.js installed (for clients that use
mcp-remoteas a proxy)
Regional endpoints
| Region | URL |
|---|---|
| US | https://mcp.mixpanel.com/mcp |
| EU | https://mcp-eu.mixpanel.com/mcp |
| IN | https://mcp-in.mixpanel.com/mcp |
Claude (claude.ai)
Use the official connector in the Claude connector directory and complete the OAuth flow. EU/IN users should add a custom connector pointing at the regional URL.
Cursor
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.mixpanel.com/mcp"]
}
}
}
Claude Desktop
Edit claude_desktop_config.json:
{
"mcpServers": {
"mixpanel": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.mixpanel.com/mcp"]
}
}
}
Gemini CLI
gemini mcp add mixpanel npx -y mcp-remote https://mcp.mixpanel.com/mcp
Codex / Notion / other clients
Add a custom MCP server of type "Streamable HTTP" and enter the regional URL. Authorize via OAuth when prompted.
Notes
- Rate limit: 600 requests/hour per user
- Required OAuth scopes:
projects analysis events insights segmentation retention data:read funnels flows data_definitions - The MCP server does not currently support HIPAA requirements
- Ask conversational questions over Mixpanel data ("What was retention for users who completed onboarding last month?") without building a dashboard
- Generate and save funnel, flow, and retention reports through an agent, then publish them to a shared dashboard via Create-Dashboard
- Investigate a specific user by pulling their event timeline plus session replays via Get-User-Replays-Data
- Audit and clean up the data lexicon: find issues, edit event/property descriptions, manage tags, and dismiss resolved items
- Manage experiments and feature flags from an AI coding assistant alongside product analytics
- "Run a funnel from Signup to Activated for the last 30 days, broken down by plan, and save it to a new dashboard called Q2 Activation."
- "Show retention for users who triggered Onboarding Completed, weekly for the past 8 weeks."
- "Pull the last 5 session replays for distinct_id user_4821 along with their key events."
- "List all events tagged deprecated in project 12345 and dismiss their governance issues."
- "Create a feature flag called new-checkout-flow with a 10% rollout in our Production project."
- Official, provider-hosted server: no infrastructure to run, no community fork to vet
- Broad tool coverage including queries, dashboards, lexicon governance, session replays, and experiments/feature flags
- OAuth 2.0 with PKCE plus inheritance of existing project permissions, with admin opt-in required at the org level
- Regional endpoints for US, EU, and India
- Does not currently support HIPAA workloads
- Rate limited to 600 requests/hour per user, which can constrain large agent workflows
- Requires an organization admin to enable MCP before any user can connect, with ~15 minute propagation delay
- Experiments and feature flag tools are still beta
- Amplitude MCP for similar product analytics querying on Amplitude data
- PostHog MCP for open product analytics, feature flags, and session replays
- Community
dragonkhoi/mixpanel-mcpGitHub server, an unofficial alternative if you prefer a self-hosted implementation