Back to Browse

Mixpanel MCP Server

Data & AnalyticsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

6.2
Moderate6.2Moderate Risk

This MCP server for Mixpanel analytics has solid authentication practices using service account credentials via environment variables, and all tools properly scope to read-only analytics operations. The main concern is the `run_jql` tool, which accepts arbitrary JavaScript code that gets executed server-side by Mixpanel, creating a potential for code injection or unintended data access. Input validation is minimal and date parameters lack format enforcement. Overall, the server is reasonably secure for its intended purpose with minor code quality improvements needed. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

4 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your Mixpanel project tokenRequired

Environment variable: MIXPANEL_TOKEN

Your Mixpanel API secretRequired

Environment variable: MIXPANEL_API_SECRET

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-mrfentmen-mixpanel-mcp": {
      "env": {
        "MIXPANEL_TOKEN": "your-mixpanel-token-here",
        "MIXPANEL_API_SECRET": "your-mixpanel-api-secret-here"
      },
      "args": [
        "-y",
        "mixpanel-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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:

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

npx mixpanel-mcp

Claude Desktop setup

{
  "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:

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

License

MIT

Reviews

No reviews yet

Be the first to review this server!