You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The Mixpanel Model Context Protocol (MCP) integration enables organizations to analyze product data using conversational AI. Teams can query events, funnels, and user behavior directly through Claude's interface using natural language, eliminating the need for complex dashboard navigation or technical query languages.
12
+
The Mixpanel Model Context Protocol (MCP) integration enables organizations to analyze product data using conversational AI. Teams can query events, funnels, and user behavior through AI interfaces (Claude, Cursor, etc.) using natural language, eliminating the need for complex dashboard navigation or technical query languages.
14
13
15
14
<Callouttype="info">
16
-
**Beta Feature:**This integration is currently in Private Beta. See [Getting Started](#getting-started) to learn how to get access.
15
+
**Beta Feature:**Help us improve this integration by sharing your feedback [here](https://docs.google.com/forms/d/e/1FAIpQLSchV5qoyiI9tmtxOkDF_4So5KKR1iiZzuqcPbwMOphQC_lEVA/viewform?usp=header).
17
16
</Callout>
18
17
19
18
---
20
19
21
-
## Key Benefits
20
+
## Mixpanel MCP Tools
21
+
The MCP integration provides access to all core Mixpanel analysis capabilities through natural language queries:
22
22
23
-
**Democratized Analytics**
24
-
- Natural language queries eliminate technical barriers
25
-
- Instant insights without dashboard complexity
26
-
- Accessible to non-technical stakeholders
23
+
### Analytics Functions
27
24
28
-
**Enhanced Productivity**
29
-
-Reduce time-to-insight from minutes to seconds
30
-
-Eliminate context switching between tools
31
-
-Enable real-time decision making
25
+
- Segmentation: Event counts and unique users with filtering and grouping (run_segmentation_query)
26
+
-Funnels: Conversion rate analysis across user journeys (run_funnels_query)
27
+
-Retention: User engagement and return behavior tracking (run_retention_query)
28
+
-Frequency: User engagement patterns and usage intensity (run_frequency_query)
32
29
33
-
**Strategic Value**
34
-
- Accelerate product discovery processes
35
-
- Enable data-driven conversations across teams
36
-
- Improve accessibility of product intelligence
30
+
### Data Discovery & Exploration
31
+
32
+
- Project Management: Access projects and workspace information (`get_projects`, `get_project_info`)
33
+
- Event Discovery: Browse all available events in your project (`get_events`)
34
+
- Event Properties: Explore properties available for each event (`get_event_properties`)
35
+
- Property Values: Discover specific values for event properties (`get_event_property_values`)
36
+
- Data Quality: Monitor and detect volume anomalies in data ingestion (`get_data_volume_anomalies`)
37
+
- Lexicon Integration: Get direct links to event definitions and documentation in Mixpanel Lexicon (`get_lexicon_detail_url`)
38
+
39
+
### Query Capabilities
40
+
41
+
- Natural Language Filtering: Use complex boolean expressions for data filtering
42
+
- Advanced Grouping: Segment data by properties with mathematical operations
43
+
- Time-based Analysis: Analyze trends across different time periods (hourly, daily, weekly, monthly)
44
+
- Numerical Aggregations: Perform sum, average, and bucket analysis on numeric properties
45
+
46
+
For more information on organizing and documenting your events, see [Mixpanel Lexicon documentation](/docs/data-governance/lexicon).
47
+
48
+
---
49
+
50
+
## Getting Started
51
+
52
+
### Beta Access
53
+
The Mixpanel MCP integration is currently in Beta. You can start using it right away by following the [Implementation Guide](#implementation-guide) below.
54
+
55
+
### Permissions & Access Control
56
+
57
+
**Admin Configuration Required**
58
+
-**Organization administrators** must enable MCP access in **Settings > Org > Overview**
59
+
- Once enabled by an admin, all Mixpanel users in the organization can use the MCP integration
60
+
- The MCP toggle controls access for the entire organization
61
+
62
+
**User Access Scope**
63
+
After the organization admin enables MCP:
64
+
- Any Mixpanel user with any role can connect to the MCP integration
65
+
- Users can only query data from projects they already have access to within Mixpanel
66
+
- Existing Mixpanel permissions and project access controls remain in effect
67
+
68
+
### Recommended Implementation Path
69
+
1.**Organization admin** enables "Enable MCP" toggle in organization settings
70
+
2.**Individual users** complete the integration setup following the [Implementation Guide](#implementation-guide)
71
+
3.**Users authenticate** with their Mixpanel account during the connection process
72
+
4.**Once authenticated, start by asking:** "What Mixpanel projects do I have access to?"
73
+
5.**Select a project** from the response to focus your analysis
74
+
6.**Ask any questions** about your Mixpanel data—refer to [Use Case Examples](#use-case-examples) below if you need ideas
75
+
7.**Begin with test data** to validate functionality
76
+
8.**Conduct security review** before production data access
77
+
9.**Train teams** on natural language query techniques
78
+
10.**Expand usage** across product and analytics teams
37
79
38
80
---
39
81
40
82
## Implementation Guide
41
83
42
-
### Option 1: Claude Pro Users (Recommended)
84
+
### Prerequisites (for Claude Free & Cursor)
85
+
**Install Node.js (if needed):**
86
+
```bash
87
+
brew install node
88
+
```
43
89
44
-
**Best for:** Teams with Claude Pro subscriptions
90
+
### Option 1: Claude Pro
45
91
46
92
**Setup Steps:**
47
93
1. Navigate to [claude.ai](https://claude.ai) or open Claude desktop app
48
-
2. Click the settings icon in the chat text box
49
-
3. Select **Add Integrations**
50
-
4. Click **Add Integration** in the new window
51
-
5. Configure the integration:
94
+
2. Go to **Settings** → **Connectors** → **Add Custom Connector**
6. Click **Connect** and complete Mixpanel authorization
98
+
4. Click **Connect** and complete Mixpanel authorization
55
99
56
-
---
100
+
For additional information on setting up Claude connectors, see [Claude's connector documentation](https://support.anthropic.com/en/articles/11724452-browsing-and-connecting-to-tools-from-the-directory).
57
101
58
-
### Option 2: Claude Free Users (Desktop Only)
102
+
---
59
103
60
-
**Prerequisites:**
61
-
- Node.js installed on your system
104
+
### Option 2: Claude Free
105
+
**Additional Requirements:**
62
106
- Claude desktop application
63
107
- Command line access
64
108
65
-
**Install Node.js (if needed):**
66
-
```bash
67
-
brew install node
68
-
```
69
-
70
109
**Setup Steps:**
71
110
1. Open Claude desktop app
72
111
2. Navigate to **Settings** (from window nav bar) → **Developer** → **Edit Config**
- Project Management: Access projects and workspace information (`get_projects`, `get_project_info`)
114
-
- Event Discovery: Browse all available events in your project (`get_events`)
115
-
- Event Properties: Explore properties available for each event (`get_event_properties`)
116
-
- Property Values: Discover specific values for event properties (`get_event_property_values`)
117
-
- Data Quality: Monitor and detect volume anomalies in data ingestion (`get_data_volume_anomalies`)
170
+
5. Complete Mixpanel authorization via the provided link
118
171
119
-
### Query Capabilities
172
+
---
120
173
121
-
- Natural Language Filtering: Use complex boolean expressions for data filtering
122
-
- Advanced Grouping: Segment data by properties with mathematical operations
123
-
- Time-based Analysis: Analyze trends across different time periods (hourly, daily, weekly, monthly)
124
-
- Numerical Aggregations: Perform sum, average, and bucket analysis on numeric properties
174
+
## Use Case Examples
125
175
126
-
---
176
+
**Channel Performance Analysis**
127
177
128
-
## Getting Started
178
+
- Query example: "Which channels drive the most users?"
179
+
- Business Value: Identify top-performing acquisition channels for budget allocation
129
180
130
-
### Beta Access
131
-
The Mixpanel MCP integration is currently in Private Beta. To request access, please sign up using [this form](https://docs.google.com/forms/d/e/1FAIpQLScOcPiQu3UP_dYBuFZ6jBIBGT-JhEU-Vgyr_o-LL3jZWqZtkQ/viewform?usp=header). Alternatively, you can reach out to your Mixpanel representative.
181
+
**Retention Intelligence**
132
182
133
-
### Recommended Implementation Path
134
-
1.**Once you are authenticated, start by asking:** "What Mixpanel projects do I have access to?"
135
-
2.**Select a project** from the response to focus your analysis
136
-
3.**Ask any questions** about your Mixpanel data—refer to [Use Case Examples](#use-case-examples) below if you need ideas on how to get started
137
-
4.**Begin with test data** to validate functionality
138
-
5.**Conduct security review** before production data access
139
-
6.**Train teams** on natural language query techniques
140
-
7.**Expand usage** across product and analytics teams
183
+
- Query: "Which channels drive users who retain best?"
184
+
- Business Value: Understand quality vs. quantity in user acquisition strategy
141
185
142
-
---
186
+
**Conversion Optimization**
143
187
144
-
## Use Case Examples
188
+
- Query: "Show me signup conversion rates by source"
189
+
- Business Value: Optimize funnel performance by traffic source
190
+
191
+
**User Journey Analysis**
145
192
146
-
### Channel Performance Analysis
147
-
Query example: "Which channels drive the most users?"
148
-
Business Value: Identify top-performing acquisition channels for budget allocation
193
+
- Query: "What's the typical user journey for power users?"
194
+
- Business Value: Identify patterns in high-value user behavior for product development
149
195
150
-
### Retention Intelligence
151
-
**Query:** "Which channels drive users who retain best?"
152
-
**Business Value:** Understand quality vs. quantity in user acquisition strategy
196
+
**Advanced Analytics**
153
197
154
-
### Conversion Optimization
155
-
**Query:** "Show me signup conversion rates by source"
156
-
**Business Value:** Optimize funnel performance by traffic source
198
+
- Query: "Compare user behavior across different feature roll outs"
199
+
- Business Value: Measure feature impact and optimize product decisions
200
+
201
+
### Key Benefits
202
+
203
+
**Democratized Analytics**
204
+
- Natural language queries eliminate technical barriers
205
+
- Instant insights without dashboard complexity
206
+
- Accessible to non-technical stakeholders
157
207
158
-
### User Journey Analysis
159
-
**Query:** "What's the typical user journey for power users?"
160
-
**Business Value:** Identify patterns in high-value user behavior for product development
208
+
**Enhanced Productivity**
209
+
- Reduce time-to-insight from minutes to seconds
210
+
- Eliminate context switching between tools
211
+
- Enable real-time decision making
161
212
162
-
### Advanced Analytics
163
-
**Query:** "Compare user behavior across different feature roll outs"
164
-
**Business Value:** Measure feature impact and optimize product decisions
213
+
**Strategic Value**
214
+
- Accelerate product discovery processes
215
+
- Enable data-driven conversations across teams
216
+
- Improve accessibility of product intelligence
165
217
166
218
---
167
219
168
220
## Security & Compliance Considerations
169
221
170
-
### Data Handling
171
-
**Important:** This integration enables querying your Mixpanel data through Claude (Anthropic's AI service). Review your organization's data handling policies before implementation.
222
+
**Data Handling**
223
+
**Important:** This integration enables querying your Mixpanel data through AI services (Claude, Cursor, etc.). Review your organization's data handling policies before implementation.
172
224
173
-
### Best Practices
174
-
- Implement appropriate access controls based on data sensitivity
0 commit comments