Mixpanel Mcp

io.github.mrfentmenPublished by GitHub account mrfentmenv1.0.3Updated Oct 30, 2026

Query Mixpanel events, funnels, retention, cohorts, and user profiles.

VerifiedSTDIODesktop onlyDatabasesData & Analytics

Overview

AI-generated overview

Local MCP server that connects an assistant to Mixpanel product analytics to query events, funnels, retention, cohorts and user profiles.

What you can do
  • Query raw event data with time ranges and filters, and list all tracked event names
  • Find the most frequently tracked events in a project
  • Get multi-step funnel conversion rates and cohort retention over days, weeks or months
  • Search and filter user profiles
  • Run custom JavaScript Query Language (JQL) analysis scripts
When to use it
Useful when you want to ask product analytics questions in natural language, such as top events this week, funnel conversion for a given funnel, or retention for users who signed up recently, without opening the Mixpanel dashboard.
Requirements
Runs locally as an npm package via npx, so Node.js is needed. Requires a Mixpanel service account and project: the manifest declares MIXPANEL_API_SECRET and MIXPANEL_TOKEN as required secrets, while the README shows MIXPANEL_SERVICE_ACCOUNT, MIXPANEL_SERVICE_SECRET and MIXPANEL_PROJECT_ID as environment variables. Network access to Mixpanel is required.
Before you install
Requires Mixpanel service account credentials, which grant API access to your project analytics and user profile data; store them only in the local environment configuration. The README's variable names differ from the manifest's declared secret names, so confirm which ones the installed version actually reads. JQL execution runs custom scripts against your project data, and profile queries can return personal data such as email addresses.

Installation

In SourceWeft

  1. Open Mixpanel Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Mixpanel MCP

An MCP server for Mixpanel product analytics. Query events, funnels, retention, cohorts, and user profiles through natural language.

What it does

Connect your Mixpanel analytics to any MCP client. Ask questions like "What are our top events this week?" or "Show me retention for users who signed up last month" and get structured answers.

Tools

  • query_events. Raw event data with time ranges and filters.
  • get_top_events. Most frequently tracked events.
  • get_funnel. Multi-step funnel conversion rates.
  • get_retention. Cohort retention over days, weeks, or months.
  • query_profiles. Search and filter user profiles.
  • run_jql. Execute raw JavaScript Query Language for custom analysis.
  • list_events. All tracked event names in your project.

Authentication

Set these environment variables:

bash
export MIXPANEL_SERVICE_ACCOUNT="your-service-account"export MIXPANEL_SERVICE_SECRET="your-service-secret"export MIXPANEL_PROJECT_ID="your-project-id"

Service accounts are created in Mixpanel under Project Settings > Service Accounts.

Install

bash
npx mixpanel-mcp

Claude Desktop setup

json
{  "mcpServers": {    "mixpanel": {      "command": "npx",      "args": ["-y", "mixpanel-mcp"],      "env": {        "MIXPANEL_SERVICE_ACCOUNT": "your-account",        "MIXPANEL_SERVICE_SECRET": "your-secret",        "MIXPANEL_PROJECT_ID": "your-project-id"      }    }  }}

Example usage

Ask Claude:

"What are our top 10 events this week?"

"Show me the conversion funnel for funnel ID 12345"

"Get retention for users who signed Up in the last 30 days"

"Run a JQL query to find users who purchased more than 3 times"

"List all events we are tracking"

"Search for user profiles with email containing @gmail.com"

JQL support

JQL (JavaScript Query Language) lets you write custom analysis scripts. Example:

javascript
function main() {  return People().filter(function (user) {    return user.properties.plan === "premium"  })}

License

MIT

Source: README.md at commit 4499588

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v1.0.3LatestSep 22, 2026
  2. v1.0.1Sep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.