MCP Directory

How to add Mixpanel MCP to Cursor

Community MCP server for the Mixpanel API — query events, funnels, retention, and user profiles from Claude or Cursor. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 19★ · stdio · apikey

Cursor config for Mixpanel MCP

npx -y @smithery/cli install @dragonkhoi/mixpanel-mcp --client claude
{
  "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>\"}"
      ]
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Mixpanel MCP config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Mixpanel MCP's tools to confirm it's connected.

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

What Mixpanel MCP can do in Cursor

get_today_top_events

Today's top events for spotting real-time activity

get_top_events

Most common events over the last 31 days

aggregate_event_counts

Unique/general/average counts for events over days, weeks, or months

aggregated_event_property_values

Aggregated values for one event and property over time

top_event_properties

Top properties for an event

top_event_property_values

Top values of a property for an event

query_insights_report

Query a saved Insights report

query_funnel_report

Conversion data from a saved funnel

Security

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Mixpanel MCP config there under the "mcpServers" key and restart the client.

Is Mixpanel MCP safe to use with Cursor?

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.

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.

View repo Full Mixpanel MCP page