> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Mixpanel

> Mixpanel is a product analytics platform tracking user interactions and engagement, providing cohort analysis, funnels, and A/B testing to improve user experiences

Mixpanel is a product analytics platform tracking user interactions and engagement, providing cohort analysis, funnels, and A/B testing to improve user experiences

`mixpanel` · **50 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth mixpanel
run auth mixpanel --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run mixpanel          # common commands
run mixpanel --all    # every command
```

```ts theme={"theme":"github-dark"}
import { mixpanel } from "@boxd/run";
```

## Common tools

| Tool                           | What it does                                                                                                                                                               |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `aggregate-event-counts`       | DEPRECATED: Use MIXPANEL\_AGGREGATE\_EVENTS instead. Tool to get unique, total, or average data for events over N days, weeks, or months.                                  |
| `cohorts-list`                 | Tool to list all saved cohorts in a Mixpanel project. Use when you need to retrieve cohort metadata including name, id, count, description, creation date, and visibility. |
| `create-service-account`       | Tool to create a new service account for your organization and optionally add it to projects.                                                                              |
| `get-all-projects`             | Get all projects associated with the authenticated Mixpanel account.                                                                                                       |
| `group-batch-update`           | Tool to send a batch of group profile updates to Mixpanel. Use when you need to update multiple group profiles in a single request.                                        |
| `group-set-property`           | DEPRECATED: Use MIXPANEL\_GROUP\_BATCH\_UPDATE instead. Tool to send batch group profile updates to Mixpanel.                                                              |
| `jql-query`                    | Execute a custom JQL (JavaScript Query Language) query against Mixpanel's Query API.                                                                                       |
| `list-cohorts`                 | DEPRECATED: Use MIXPANEL\_MIXPANEL\_COHORTS\_LIST instead. Get list of all cohorts in a Mixpanel project.                                                                  |
| `list-funnels`                 | Get the names and funnel\_ids of your funnels. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                |
| `list-saved-cohorts`           | DEPRECATED: Use MIXPANEL\_MIXPANEL\_COHORTS\_LIST instead. Tool to list all saved cohorts in a Mixpanel project.                                                           |
| `list-service-accounts`        | Tool to list all service accounts for an organization. Use when you need to retrieve service accounts, check when they were last used, or see when they expire.            |
| `profile-batch-update`         | Tool to update multiple user profiles in Mixpanel in a single batch request.                                                                                               |
| `profile-event-activity`       | Get event activity feed for specified users from Mixpanel Query API.                                                                                                       |
| `profile-set`                  | Tool to set user profile properties in Mixpanel using the \$set operation.                                                                                                 |
| `query-funnel`                 | Get data for a funnel. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                                        |
| `query-insight`                | Get data from your Insights reports. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                          |
| `query-months-top-event-names` | DEPRECATED: Use MIXPANEL\_TOP\_EVENTS instead. Get a list of the most common event names over the last 31 days.                                                            |
| `query-profiles`               | Query user or group profile data from Mixpanel. Returns list of profiles that match specified parameters.                                                                  |
| `query-segmentation`           | Get data for an event, segmented and filtered by properties with daily/time-series breakdown.                                                                              |
| `query-top-events`             | Get the top events for today, with their counts and the normalized percent change from yesterday.                                                                          |
| `segmentation-numeric-query`   | Tool to get event data numerically bucketed by property values.                                                                                                            |
| `set-group-property-once`      | Tool to set properties on a Mixpanel group profile only if they don't already exist.                                                                                       |

<Accordion title="All 50 tools" icon="list">
  | Tool                                  | What it does                                                                                                                                                               |
  | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `add-unique-to-profile-list-property` | Tool to add unique values to list properties on user profiles in Mixpanel using the \$union operation.                                                                     |
  | `aggregated-event-property-values`    | Get unique, total, or average data for a single event and property over days, weeks, or months.                                                                            |
  | `aggregate-event-counts`              | DEPRECATED: Use MIXPANEL\_AGGREGATE\_EVENTS instead. Tool to get unique, total, or average data for events over N days, weeks, or months.                                  |
  | `aggregate-events`                    | Get aggregate event counts over time. Supports different types of aggregation: general, unique, average, sum.                                                              |
  | `cohorts-list`                        | Tool to list all saved cohorts in a Mixpanel project. Use when you need to retrieve cohort metadata including name, id, count, description, creation date, and visibility. |
  | `create-annotation-tag`               | Tool to create a new annotation tag in Mixpanel using the provided name.                                                                                                   |
  | `create-identity`                     | Tool to create an identity mapping in Mixpanel by linking an anonymous ID with an identified user ID.                                                                      |
  | `create-service-account`              | Tool to create a new service account for your organization and optionally add it to projects.                                                                              |
  | `delete-group`                        | Tool to permanently delete a group profile from Mixpanel Group Analytics.                                                                                                  |
  | `delete-profile`                      | Tool to permanently delete a user profile from Mixpanel, along with all of its properties.                                                                                 |
  | `delete-profile-batch`                | Tool to permanently delete multiple user profiles from Mixpanel in a single batch request.                                                                                 |
  | `delete-profile-property`             | Tool to permanently delete properties from a Mixpanel user profile using the \$unset operation.                                                                            |
  | `get-all-projects`                    | Get all projects associated with the authenticated Mixpanel account.                                                                                                       |
  | `get-annotation-tags-alt1`            | Tool to get all annotation tags from a Mixpanel project. Use when you need to retrieve tags that have been added to annotations.                                           |
  | `group-batch-update`                  | Tool to send a batch of group profile updates to Mixpanel. Use when you need to update multiple group profiles in a single request.                                        |
  | `group-delete-property`               | Tool to delete specific properties from a Mixpanel group profile.                                                                                                          |
  | `group-set-property`                  | DEPRECATED: Use MIXPANEL\_GROUP\_BATCH\_UPDATE instead. Tool to send batch group profile updates to Mixpanel.                                                              |
  | `identity-create-alias`               | Tool to create an alias mapping between two distinct IDs in Mixpanel.                                                                                                      |
  | `jql-query`                           | Execute a custom JQL (JavaScript Query Language) query against Mixpanel's Query API.                                                                                       |
  | `list-cohorts`                        | DEPRECATED: Use MIXPANEL\_MIXPANEL\_COHORTS\_LIST instead. Get list of all cohorts in a Mixpanel project.                                                                  |
  | `list-funnels`                        | Get the names and funnel\_ids of your funnels. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                |
  | `list-saved-cohorts`                  | DEPRECATED: Use MIXPANEL\_MIXPANEL\_COHORTS\_LIST instead. Tool to list all saved cohorts in a Mixpanel project.                                                           |
  | `list-service-accounts`               | Tool to list all service accounts for an organization. Use when you need to retrieve service accounts, check when they were last used, or see when they expire.            |
  | `profile-append-to-list-property`     | Tool to append values to list properties on user profiles in Mixpanel.                                                                                                     |
  | `profile-batch-update`                | Tool to update multiple user profiles in Mixpanel in a single batch request.                                                                                               |
  | `profile-delete-property`             | DEPRECATED: Use MIXPANEL\_DELETE\_PROFILE\_PROPERTY instead. Tool to permanently delete properties from a user profile in Mixpanel.                                        |
  | `profile-event-activity`              | Get event activity feed for specified users from Mixpanel Query API.                                                                                                       |
  | `profile-numerical-add`               | Tool to increment or decrement numerical properties on user profiles in Mixpanel.                                                                                          |
  | `profile-remove-from-list-property`   | Tool to remove values from list properties on user profiles in Mixpanel.                                                                                                   |
  | `profile-set`                         | Tool to set user profile properties in Mixpanel using the \$set operation.                                                                                                 |
  | `query-frequency-report`              | Get data about how frequently users are performing events. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                    |
  | `query-funnel`                        | Get data for a funnel. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                                        |
  | `query-insight`                       | Get data from your Insights reports. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                          |
  | `query-months-top-event-names`        | DEPRECATED: Use MIXPANEL\_TOP\_EVENTS instead. Get a list of the most common event names over the last 31 days.                                                            |
  | `query-numeric-average`               | Averages an expression for events per unit time. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                              |
  | `query-numeric-sum`                   | Sums an expression for events per unit time. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                  |
  | `query-profiles`                      | Query user or group profile data from Mixpanel. Returns list of profiles that match specified parameters.                                                                  |
  | `query-retention-report`              | Query cohort analysis showing user retention patterns over time.                                                                                                           |
  | `query-segmentation`                  | Get data for an event, segmented and filtered by properties with daily/time-series breakdown.                                                                              |
  | `query-top-events`                    | Get the top events for today, with their counts and the normalized percent change from yesterday.                                                                          |
  | `remove-from-group-list-property`     | Tool to remove values from list properties on group profiles in Mixpanel.                                                                                                  |
  | `remove-from-list-property`           | Tool to remove values from list properties on user profiles in Mixpanel using the \$remove operation.                                                                      |
  | `segmentation-numeric-query`          | Tool to get event data numerically bucketed by property values.                                                                                                            |
  | `set-group-property-once`             | Tool to set properties on a Mixpanel group profile only if they don't already exist.                                                                                       |
  | `set-profile-property-once`           | Tool to set user profile properties in Mixpanel using the \$set\_once operation.                                                                                           |
  | `todays-top-events`                   | DEPRECATED: Use MIXPANEL\_QUERY\_TOP\_EVENTS instead. Get the top events for today, with their counts and the normalized percent change from yesterday.                    |
  | `top-event-properties`                | Get the top property names for an event. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                                      |
  | `top-event-property-values`           | Tool to get the top values for a property ordered by frequency.                                                                                                            |
  | `top-events`                          | Get a list of the most common events over the last 31 days. The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.                   |
  | `update-group-list-property`          | Tool to add unique values to list properties on group profiles in Mixpanel.                                                                                                |
</Accordion>

[Open Mixpanel in the console →](https://app.boxd.sh/integrations/detail/mixpanel)
