Mixpanel logo
Analytics & MarketingAuth: OAuthHosting: Official hosted

Mixpanel MCP Server

Connect Claude, Cursor, and AI agents to your Mixpanel product analytics over MCP.

Updated

What is Mixpanel MCP?

The Mixpanel MCP server is a Model Context Protocol server that connects AI assistants and agents directly to your Mixpanel product analytics — events, funnels, retention, cohorts, reports, and dashboards — so they can answer questions and run analyses in natural language.

It is an official, Mixpanel-hosted remote server reachable at https://mcp.mixpanel.com/mcp (with EU and IN regional endpoints available). Because it is hosted by Mixpanel, there is nothing to deploy or maintain — you point a compatible client at the URL and authenticate. Access is scoped to the projects you already have permission to see, and an organization admin must first enable MCP in the Mixpanel org settings.

Authentication uses OAuth (Authorization Code with PKCE and refresh-token support), so the first connection prompts you to authorize in the browser rather than pasting a long-lived key. A beta Service Account method using static bearer headers is also available for automated, headless setups.

Tools the Mixpanel MCP server exposes

ToolWhat it does
Run-QueryRun an analytics query against your Mixpanel data.
Get-ReportRetrieve a saved report's results.
Get-EventsList the events tracked in a project.
List-PropertiesList event and user properties and their definitions.
Get-Property-ValuesFetch the distinct values for a given property.
Search-EntitiesSearch across events, properties, and other entities.
Create-DashboardCreate a new dashboard in a project.
List-DashboardsList the dashboards in a project.
Create-MetricCreate a tracked metric.
Get-User-Replays-DataRetrieve session replay data for a user.

Connect the Mixpanel MCP server

Claude Code

  1. 1

    Add the Mixpanel MCP server

    Run: claude mcp add mixpanel npx -y mcp-remote https://mcp.mixpanel.com/mcp

  2. 2

    Authorize via OAuth

    On first use the mcp-remote bridge opens a browser to complete Mixpanel's OAuth (Authorization Code + PKCE) flow. Approve access for your projects.

  3. 3

    Ensure MCP is enabled

    Confirm a Mixpanel org admin has enabled MCP in Settings -> Org -> Overview, then start a Claude Code session and call the Mixpanel tools.

Cursor

  1. 1

    Open MCP settings

    Go to Settings -> Tools & MCP -> New MCP Server (edits ~/.cursor/mcp.json).

  2. 2

    Add the server config

    Add: {"mcpServers":{"mixpanel":{"command":"npx","args":["-y","mcp-remote","https://mcp.mixpanel.com/mcp"]}}}

  3. 3

    Authorize on first connect

    Cursor prompts you to authorize via Mixpanel OAuth in the browser. After approving, the Mixpanel tools become available in chat.

Sample use cases

An analyst asks Claude, in plain English, to break down last week's signup funnel by acquisition channel.

The agent runs the query against Mixpanel and returns the funnel without anyone opening the Mixpanel UI.

A scheduled Gamut agent checks a key activation metric every morning.

It fetches the metric via MCP and posts a trend summary to the team channel.

A PM wants to understand which events and properties exist before building a report.

The agent lists events and property definitions through the discovery tools to map the schema.

Security & permissions

The official server authenticates with OAuth (Authorization Code + PKCE, S256) with refresh-token support, so no long-lived secret is stored in your client config. The agent's access is scoped to the Mixpanel projects your user account already has permission to view — it cannot reach data you can't see in the Mixpanel UI. An organization admin must explicitly enable MCP before any connection works, and usage is capped at 600 requests/hour per user. A beta Service Account option uses static bearer-header credentials for headless/CI use. Note: Mixpanel documents that this feature does not currently support HIPAA requirements and is not covered by its BAA.

Using Mixpanel MCP with Gamut

In a Gamut workflow, a scheduled or event-triggered agent can use the Mixpanel MCP server as a tool to pull product-analytics signals on its own — for example, running a funnel or retention query each morning, fetching a saved report, or summarizing how a tracked metric moved week over week, then routing the result into a Slack message or a follow-up action. Gamut manages the OAuth connection so the agent authenticates against your Mixpanel projects without manual key handling, and access stays limited to the projects and rate limits Mixpanel enforces.

Frequently asked questions

What is the Mixpanel MCP server?

It is an official, Mixpanel-hosted Model Context Protocol server at https://mcp.mixpanel.com/mcp that lets AI assistants and agents query your Mixpanel product analytics — events, funnels, retention, reports, and dashboards — in natural language.

Is the Mixpanel MCP server free?

Mixpanel does not document a separate fee for the MCP server; access is tied to your existing Mixpanel account and project permissions. An org admin must enable MCP in settings, and usage is limited to 600 requests per hour per user.

How do I connect the Mixpanel MCP server to Claude or Cursor?

Point the client at https://mcp.mixpanel.com/mcp using the mcp-remote bridge (npx -y mcp-remote https://mcp.mixpanel.com/mcp). On first connect you authorize through Mixpanel's OAuth flow in the browser — no static key needed for interactive use.

Is the Mixpanel MCP server hosted or self-hosted?

It is hosted by Mixpanel as a remote server, with US, EU, and IN regional endpoints. There is nothing to deploy or maintain — you connect a compatible client and authenticate with OAuth.