Mixpanel MCP
Community MCP server for the Mixpanel API — query events, funnels, retention, and user profiles from Claude or Cursor.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @smithery/cli install @dragonkhoi/mixpanel-mcp --client claudePaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mixpanel-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"run",
"@dragonkhoi/mixpanel-mcp",
"--config",
"{\"username\":\"<your-service-account-username>\",\"password\":\"<your-service-account-password>\",\"projectId\":\"<your-mixpanel-project-id>\"}"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- A Mixpanel service account (Organization Settings → Service Accounts) — note its username and password
- Your Mixpanel project ID (Project Settings)
- Node.js with npx available
About Mixpanel MCP
The whole server is one TypeScript file that maps 19 tools onto Mixpanel's query API, authenticating with service-account basic auth. Credentials arrive as three arguments (service account username, password, project ID) — via Smithery's --config JSON when installed that way, or as positional args when you run the built index.js with node.
Coverage focuses on on-demand lookups rather than dashboarding: today's top events, top events over 31 days, aggregate counts by day/week/month, funnel and retention reports (including saved funnels and cohorts), frequency, four segmentation variants (report/sum/average/bucket), profile queries, per-profile event activity, and a custom_jql escape hatch for anything the fixed tools miss.
The trade-offs are what you'd expect from a 19-star early project: no standalone npm package (it runs through Smithery's CLI or a local clone), no commits since March 2025, partial API coverage (no annotations, no data ingestion), and credentials living in plaintext client config. If you want an officially supported analytics MCP, Amplitude's hosted server is the comparison point; if you specifically need Mixpanel answers in chat and accept prototype status, this does the job.
Because every tool is a read against report endpoints, the blast radius is limited to data exposure rather than data modification — scope the service account to one project and the risk profile stays small.
Tools & capabilities (19)
get_today_top_eventsToday's top events for spotting real-time activity
get_top_eventsMost common events over the last 31 days
aggregate_event_countsUnique/general/average counts for events over days, weeks, or months
aggregated_event_property_valuesAggregated values for one event and property over time
top_event_propertiesTop properties for an event
top_event_property_valuesTop values of a property for an event
query_insights_reportQuery a saved Insights report
query_funnel_reportConversion data from a saved funnel
list_saved_funnelsList saved funnels with IDs
list_saved_cohortsList saved cohorts with IDs
query_retention_reportRetention analysis (e.g. weekly retention for a cohort)
query_frequency_reportHow often users perform an event
query_segmentation_reportSegment an event by a property
query_segmentation_sumSum a numeric expression per time unit
query_segmentation_averageAverage a numeric expression per time unit
query_segmentation_bucketSegmentation with numeric bucketing
query_profilesQuery user profiles with filters
profile_event_activityEvent activity stream for a specific profile
custom_jqlRun a custom JQL script against project data
What this server can do
Mixpanel MCP provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Ask for weekly retention of a specific signup cohort during a growth review
- Check funnel conversion numbers without opening the Mixpanel UI
- Get a quick overview of today's top events while debugging a tracking change
- Run one-off JQL for questions the standard reports don't answer
Quick setup
- 1Create a service account in Mixpanel Organization Settings and copy its username and password
- 2Find your project ID in Mixpanel Project Settings
- 3Claude Desktop: npx -y @smithery/cli install @dragonkhoi/mixpanel-mcp --client claude
- 4Cursor: add a command-type MCP server running npx -y @smithery/cli@latest run @dragonkhoi/mixpanel-mcp --config '{"username":"...","password":"...","projectId":"..."}'
- 5Test with "What are the top events today?"
Security notes
Service-account credentials and the project ID are passed as plaintext command-line arguments in your client config, so create a service account scoped to just the project you need. It's a tiny community project with no commits since March 2025 — the single-file TypeScript source is quick to review before trusting it with production analytics credentials.
Mixpanel MCP FAQ
Is mixpanel-mcp safe to use with my Mixpanel account?
Reasonably, with caveats: it's MIT-licensed open source that only calls Mixpanel's query endpoints, so it reads analytics but never modifies project data. The real risks are stale maintenance (no commits since March 2025) and service-account credentials sitting in plaintext config — scope that account to a single project.
Is this an official Mixpanel server?
No. It's a personal community project by dragonkhoi with ~19 stars; Mixpanel neither maintains nor endorses it. The author states API coverage is being added over time, but the commit history stops in March 2025.
What can it actually query?
Events (top events, aggregate counts, property breakdowns), funnels and saved funnels, retention and frequency, four segmentation modes, saved cohorts, user profiles and per-profile activity, plus raw JQL for anything else. There are no write or ingestion tools.
Alternatives to Mixpanel MCP
Compare all alternatives →
Official Elastic server: list indices, read mappings, and search with Query DSL.
Official PostHog server: product analytics, feature flags, experiments, error tracking and SQL.
Run PromQL queries and analyze Prometheus metrics from any MCP client.