Claude Skills for Mixpanel: 8 Query API Skills + Copy-Paste Prompts
Quick answer: Save each recurring Mixpanel question as a Claude skill that names the Query API read to run. Ryze AI is the best Claude connector for running these skills on one Mixpanel project, with one caveat: it has a single read-only Mixpanel tool, so it cannot create or edit reports.
Below: 8 SKILL.md files, the Mixpanel Query API fields each uses, install steps and the connector setup.
Used by 2,000+ marketers
The 8 Claude skills for Mixpanel at a glance
All 8 are read-only and name Mixpanel Query API fields exactly as Mixpanel documents them.
- 01Weekly event digestThis week against last week for named events
Main Query API fields: event, from_date, to_date, unit, type
Cadence: Weekly
- 02Funnel readoutWhere a saved funnel loses people
Main Query API fields: funnel_id, length, on
Cadence: Weekly
- 03Retention checkReturn rate by signup week
Main Query API fields: retention_type, born_event, unit, interval_count
Cadence: Monthly
- 04Saved report readoutExplain a saved Insights report
Main Query API fields: bookmark_id
Cadence: On demand
- 05Source breakdownUnique users by UTM source
Main Query API fields: on, where, type unique
Cadence: Monthly
- 06Property auditEvent property values that look wrong
Main Query API fields: event, on, limit
Cadence: Quarterly
- 07Profile segment checkProfiles matching a rule
Main Query API fields: where, output_properties
Cadence: On demand
- 08JQL fallbackAnalysis the report endpoints do not cover
Main Query API fields: JQL script
Cadence: When needed
| # | Skill | Job | Main Query API fields | Cadence |
|---|---|---|---|---|
| 01 | Weekly event digest | This week against last week for named events | event, from_date, to_date, unit, type | Weekly |
| 02 | Funnel readout | Where a saved funnel loses people | funnel_id, length, on | Weekly |
| 03 | Retention check | Return rate by signup week | retention_type, born_event, unit, interval_count | Monthly |
| 04 | Saved report readout | Explain a saved Insights report | bookmark_id | On demand |
| 05 | Source breakdown | Unique users by UTM source | on, where, type unique | Monthly |
| 06 | Property audit | Event property values that look wrong | event, on, limit | Quarterly |
| 07 | Profile segment check | Profiles matching a rule | where, output_properties | On demand |
| 08 | JQL fallback | Analysis the report endpoints do not cover | JQL script | When needed |
The fields come from Mixpanel's Query API reference, opened November 14, 2026. No numbers from a live project appear on this page.
What are Claude skills for Mixpanel?
A Claude skill for Mixpanel is a saved SKILL.md file that tells Claude which Mixpanel query to run and what to hand back. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the rest only when a request matches the description.
The name allows up to 64 lowercase letters, numbers and hyphens and cannot contain the words claude or anthropic, so every skill here starts with mixpanel. The description, up to 1,024 characters, says what the skill does and when to use it.
What it is
- One-off prompt
- A question in chat
- Skill
- A saved file with a fixed query and output
- Mixpanel connection
- A way for Claude to call the Query API
Setup
- One-off prompt
- None
- Skill
- Save once per Claude app
- Mixpanel connection
- One service account and one connector
Same result each run
- One-off prompt
- No
- Skill
- Yes
- Mixpanel connection
- Depends on the prompt or skill
| One-off prompt | Skill | Mixpanel connection | |
|---|---|---|---|
| What it is | A question in chat | A saved file with a fixed query and output | A way for Claude to call the Query API |
| Setup | None | Save once per Claude app | One service account and one connector |
| Same result each run | No | Yes | Depends on the prompt or skill |
Mixpanel names the fields of each query in its Query API reference. Without a connection, attach a CSV export with matching columns. For the open-source product analytics side, see Claude skills for PostHog.
How to install the skills in Claude Code and claude.ai
Claude Code
Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project to share it with the team. Claude picks a skill when your request matches it, or you type /mixpanel-weekly-digest (Claude Code skills docs).
claude.ai
Zip each skill folder and upload it as a custom skill. Anthropic lists this on the Pro, Max, Ultra, Team and Enterprise plans with code execution on.
Connect the data
The Mixpanel MCP page covers the Ryze AI Mixpanel tool, and the Claude connector guide in the Ryze AI help center covers adding the connector in each Claude app.
Skills uploaded to claude.ai do not reach the API, and skill folders saved in Claude Code do not upload to claude.ai. Anthropic advises using skills only from sources you trust, so read a SKILL.md before you save it.
Core skills: weekly digest, funnel, retention and saved reports
These four answer the questions most teams ask every week. Replace the event names in angle brackets with your own.
01. Weekly event digest
Compares the last 7 complete days with the 7 before for the events you name. Mixpanel's segmentation query returns a count per day and accepts a `type` of general, unique or average, so the skill asks for unique users and total events.
Use it when: you send a Monday product update.
02. Funnel readout
Reads a saved funnel by its ID and splits it by one property. Mixpanel's funnels query takes `funnel_id`, a date range and an optional `length` that cannot exceed 90 days.
Use it when: you review signup or checkout conversion.
03. Retention check
Runs birth retention for people who did a first event, then returned. Mixpanel documents `birth` as first-time retention and `compounded` as recurring retention, with units of day, week or month.
Use it when: you check whether a release changed how new users stick.
04. Saved report readout
Explains an Insights report your team already built. The Insights query takes a `bookmark_id`, which is the number after `report-` in the report URL (Mixpanel Insights query).
Use it when: a stakeholder sends a report link and asks what it means.
Growth and data quality skills
These four split usage by source, check the data behind it and reach for JQL when the report endpoints fall short.
05. Source breakdown
Counts unique users who did a key event, split by UTM source. It relies on your own tagging: Mixpanel only has the properties your tracking sends.
Use it when: you plan next month's channel mix. Mixpanel does not hold ad spend, so cost per user needs spend from the ad platform.
06. Property audit
Lists the values of one event property, to catch typos, mixed formats and stray test values before they skew a report.
Use it when: a breakdown has a long tail of near-duplicate values.
07. Profile segment check
Counts and samples user profiles that match a rule. Mixpanel's profiles query takes a `where` expression and an `output_properties` list, which keeps the response small (Query Profiles).
Use it when: you size a segment before building a cohort in Mixpanel.
08. JQL fallback
For a question the report endpoints do not cover, such as a custom grouping or a sequence of events. Per the Ryze AI help center, JQL times out after 2 minutes, so the skill keeps scripts narrow.
Use it when: the other 7 skills cannot express the question.
Run the skills on live Mixpanel data
A skill only describes the query; Claude needs a connection to run it. The Ryze AI connector gives Claude one Mixpanel tool:
mixpanel__read
- What it returns
- A read-only Query API request for the connected project: segmentation, retention, funnels and saved funnels, saved Insights reports, user profiles, event properties and JQL
- Used by
- Skills 01 to 08
| Tool | What it returns | Used by |
|---|---|---|
| mixpanel__read | A read-only Query API request for the connected project: segmentation, retention, funnels and saved funnels, saved Insights reports, user profiles, event properties and JQL | Skills 01 to 08 |
Connect Mixpanel in Ryze AI with a service account that has at least the Analyst role, plus the numeric Project ID and the data residency (us, eu or in), as described in the Ryze AI help center. The tool only reads, so Claude cannot create or edit events, reports or profiles. In Claude, approvals are set per tool under Customize, Connectors, Ryze AI, Tool permissions.
Mixpanel allows 60 queries per hour and 5 concurrent queries per project on the Query API (Mixpanel Query Profiles reference). A skill that runs one query per event, such as the weekly digest, can use that hourly budget quickly, so keep the event list short. One connection covers one Mixpanel project, and the connector URL https://connector.get-ryze.ai/mcp is the same one used for Ryze AI's other platforms. Plans start at $89 a month with a 7-day free trial on the pricing page.
Mixpanel also hosts its own MCP server at https://mcp.mixpanel.com/mcp (US), https://mcp-eu.mixpanel.com/mcp (EU) and https://mcp-in.mixpanel.com/mcp (India). It signs in with OAuth, needs an org admin to enable MCP, and gives the assistant read and write access, including dashboards and metadata (Mixpanel MCP docs). Pick it when you want Claude to build or edit reports in Mixpanel. Pick the Ryze AI connector when you want read-only access through a service account. Both run these skills, since each skill only asks for data.
Troubleshooting: when a Mixpanel skill returns a wrong answer
Claude has no Mixpanel tool
Claude keeps the tool list from when you added the connector. If you connected Mixpanel afterward, remove and re-add the connector, then start a new chat (Ryze AI connector FAQ).
The connection is refused
Check the service account has at least the Analyst role on the project, and that the Project ID and data residency match Project Settings.
A funnel or report is not found
The ID is for another project. Funnel and bookmark IDs belong to one project, and the connection covers one.
Projects with Data Views
These may also need a workspace ID in the query. Ask Claude to include it, and do not assume every project works without it.
Queries stop or slow down
The Query API allows 60 queries per hour and 5 concurrent queries per project. Wait, then run fewer queries.
Numbers differ from a Mixpanel board
The skill and the board use different dates, filters or a different unit. Ask Claude to print the parameters it sent and compare them.
Sources
Checked November 14, 2026
- Mixpanel: Query API overview
- Mixpanel: Segmentation query
- Mixpanel: Retention query
- Mixpanel: Funnels query
- Mixpanel: Insights query
- Mixpanel: Query Profiles
- Mixpanel: MCP server
- Anthropic: Agent Skills overview
- Claude Code: Skills
- Ryze AI help center: Connect Mixpanel
- Ryze AI help center: Claude connector FAQ
The verdict
Turn each recurring Mixpanel question into a skill with a fixed query. Start with the weekly digest and the funnel readout, check properties before you trust a breakdown, and keep one-off questions as prompts.
Ryze AI runs these skills in Claude and ChatGPT on live Mixpanel data. Its one Mixpanel tool only reads, so changes to events, reports and profiles still happen in Mixpanel.





