Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

Mixpanel

Query your Mixpanel product analytics through the Modem Agent

The Mixpanel integration connects your Mixpanel account to the Modem Agent. Once connected, the agent can query your product analytics on demand: events, funnels, retention, segmentation, and more.

Prerequisites

  • Admin or Owner role in your Modem organization
  • A Mixpanel account with access to the projects you want to query
  • MCP access enabled in your Mixpanel organization (see step 1 below)

Setup

Enable MCP access in Mixpanel

A Mixpanel organization admin must enable MCP access in Mixpanel under Settings → Org → Overview before anyone can connect. Changes can take up to 15 minutes to take effect.

Connect in Modem

Go to Settings → Integrations → Mixpanel in your Modem dashboard.

  1. Select your Region (US Cloud, EU Cloud, or India Cloud) to match where your Mixpanel data lives
  2. Click Connect

Authorize with Mixpanel

You’ll be redirected to Mixpanel to sign in and approve the connection. Modem requests read-only analytics scopes. After you approve, you’re returned to the integration settings page.

Choose tools (optional)

Once connected, the settings page lists every tool Mixpanel provides. All tools are available to the agent by default. You can disable individual tools, and use Refresh to pick up tools Mixpanel has added or changed. See Managing Tools below.

What the Agent Can Access

The agent’s Mixpanel tools are provided by Mixpanel’s hosted MCP server and cover its analysis surface:

Category Examples
Events Event volumes and trends over time
Segmentation Breakdowns by property, cohort, or user attribute
Funnels Conversion rates and drop-off between steps
Retention How often users come back after their first action
Flows The paths users take through your product
Data definitions Your project’s event and property catalog

Access is read-only. Modem requests only read analytics scopes during authorization, so the agent cannot modify anything in Mixpanel.

The exact tool list comes from Mixpanel and can change over time. The integration settings page always shows the current set.

What the Agent Can Do

With Mixpanel connected, you can ask the agent to:

  • Query product usage metrics (active users, event counts, adoption)
  • Break down metrics by property, cohort, or segment
  • Analyze funnel conversion and retention
  • Explore your event and property definitions
  • Cross-reference Mixpanel analytics with feedback from your data sources

Example Prompts

These work from the dashboard, Slack DMs, or by mentioning @modem in a channel.

Simple:

PromptHow many users triggered the export event last week?
PromptWhat's our week-over-week retention for new signups?
PromptWhich events do we track around onboarding?

Advanced:

PromptCompare signup funnel conversion this month vs last month and tell me where drop-off changed
PromptBreak down active users by plan tier for the last 30 days
PromptCross-reference our most-used features in Mixpanel with the top complaint topics in Modem

Managing Tools

After connecting, the integration settings page shows a tool selection card:

  • Enable or disable individual tools. Disabled tools are hidden from the agent. Changes require an Admin or Owner role.
  • Refresh fetches the latest tool list from Mixpanel and reports anything added, removed, or updated.
  • Test Connection verifies your authorization still works and reports how many tools are available.

Troubleshooting

Authorization fails on Mixpanel's side

MCP access must be enabled by a Mixpanel organization admin under Settings → Org → Overview in Mixpanel. After enabling it, changes can take up to 15 minutes to take effect. Also confirm you selected the region that matches your Mixpanel data center.

Status shows 'Authorization expired' or 'needs attention'

Mixpanel access tokens expire. Click Reconnect on the integration settings page to re-authorize. If the problem persists, the last error is shown on the settings page.

Error about a custom MCP server with the slug 'mixpanel'

If you previously added Mixpanel as a custom server on the External MCP Servers page, remove it there first, then connect the Mixpanel integration.

Agent says Mixpanel tools aren't available

Confirm Mixpanel is connected and the status dot is green, then run Test Connection to check the authorization is still valid. If both look fine, check the tool selection card in case the tool you need was disabled.

Disconnecting

To disconnect Mixpanel:

  1. Go to Settings → Integrations → Mixpanel
  2. Click Disconnect and confirm

Disconnecting removes the connection and its stored credentials. Because Mixpanel is query-only, no Mixpanel data was stored in Modem to begin with; past agent conversations that referenced Mixpanel results remain in your chat history. Nothing is deleted from Mixpanel, and you can reconnect at any time.

Was this page helpful?