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

# Mixpanel

# Mixpanel

> Where to find your Mixpanel project token + service account, and how to connect them to Nora.

Mixpanel integrations let your agents send events to Mixpanel and query existing analytics via the Service Account API.

## Where to apply for credentials

<Card title="Mixpanel — Project settings" href="https://mixpanel.com/settings/project" icon="pie-chart" arrow>
  Project settings
</Card>

<Steps>
  <Step title="Copy the Project Token">
    Project settings → Overview → **Project Token**. This is what client SDKs use for ingestion.
  </Step>

  <Step title="(For server-side) Create a Service Account">
    Project settings → **Access security** → **Service accounts** → Create. Pick a role (Project Member, Project Admin, Viewer). Copy the Username + Secret.
  </Step>
</Steps>

## Connect in Nora

| Field                    | Value                                                              |
| ------------------------ | ------------------------------------------------------------------ |
| Project Token            | For ingestion (the `track` API).                                   |
| API Secret               | The Service Account secret (server-side queries).                  |
| Service Account Username | The Service Account username.                                      |
| Project ID               | Numeric ID from the Project URL (`mixpanel.com/project/<id>/...`). |

Nora calls `/api/app/me/` with HTTP Basic when an SA username is set, otherwise stores the project token without verification (Mixpanel doesn't expose a write-key validation endpoint).

## MCP server

No official Mixpanel MCP server today.

## Environment variables Nora injects

| Variable                            | Source               |
| ----------------------------------- | -------------------- |
| `MIXPANEL_API_SECRET`               | API Secret field     |
| `MIXPANEL_SERVICE_ACCOUNT_USERNAME` | SA Username (if set) |
| `MIXPANEL_PROJECT_ID`               | Project ID (if set)  |
