MCP Directory

How to add Mixpanel MCP to Windsurf

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

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Mixpanel MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Mixpanel MCP's tools become available to Cascade.

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 Windsurf

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Mixpanel MCP config there under the "mcpServers" key and restart the client.

Is Mixpanel MCP safe to use with Windsurf?

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