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.
- Select your Region (US Cloud, EU Cloud, or India Cloud) to match where your Mixpanel data lives
- 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:
Advanced:
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:
- Go to Settings → Integrations → Mixpanel
- 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.