Mixpanel MCP

Simple MCP server that interfaces with the Mixpanel API, allowing you to talk to your Mixpanel events data from any MCP client like Cursor or Claude Desktop. Query events data, retention, and funnels. Great for on-demand look ups like: "What's the weekly retention for users in the Feb 1 cohort?"

I am adding more coverage of the Mixpanel API over time, let me know which tools you need or just open a PR.

Development

For Contributors

如果你想参与开发或发布新版本：

• 📖 发布脚本使用指南 - 自动化发布脚本的详细说明
• 🔑 使用 Token 发布 - 使用 npm access token 发布（推荐）
• 📝 发布 1.0.0 说明 - 首次发布指南
• 📦 发布文档 - 完整的发布流程
• 🔧 Registry 配置 - 修复 npm registry 问题

快速发布：

# 使用 npm access token（推荐）
export NPM_TOKEN=npm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
npm run publish:token

# 或使用交互式登录
npm run publish:current  # 发布当前版本（首次发布）
npm run release:patch    # 1.0.0 -> 1.0.1
npm run release:minor    # 1.0.0 -> 1.1.0
npm run release:major    # 1.0.0 -> 2.0.0

Installation

Make sure to go to your Mixpanel Organization Settings to set up a Mixpanel Service Account, get the username, password, and your project ID (in Mixpanel Project Settings).

Installing via Smithery

To install mixpanel-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dragonkhoi/mixpanel-mcp --client claude

To install mixpanel-mcp for Cursor, go to Settings -> Cursor Settings -> Features -> MCP Servers -> + Add

Select Type: command and paste the below, using the arguments <USERNAME> <PW> <PROJECT_ID> from Mixpanel

npx -y @smithery/cli@latest run @dragonkhoi/mixpanel-mcp --config "{\"username\":\"YOUR_SERVICE_ACCT_USERNAME\",\"password\":\"YOUR_SERVICE_ACCT_PASSWORD\",\"projectId\":\"YOUR_MIXPANEL_PROJECT_ID\"}"

Clone and run locally

Clone this repo Run npm run build Paste this command into Cursor (or whatever MCP Client) node /ABSOLUTE/PATH/TO/mixpanel-mcp/build/index.js YOUR_SERVICE_ACCOUNT_USERNAME YOUR_SERVICE_ACCOUNT_PASSWORD YOUR_PROJECT_ID

Examples

• Ask about retention numbers

• Ask for an overview of events