mixpanel-headless-setup

Installs Mixpanel analytics dependencies and verifies service account or OAuth credentials.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill mixpanel-headless-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mixpanel-headless-setup
Source: https://github.com/openai/plugins/tree/main/plugins/mixpanel-headless/skills/setup
Command: npx skills add https://github.com/openai/plugins --skill mixpanel-headless-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mixpanel-headless, pandas, numpy, matplotlib, seaborn, networkx, anytree, scipy, pyarrow, and includes scripts (resource) components.

What problem does it solve?

Setting up a Python environment for Mixpanel data analysis requires installing multiple packages and configuring credentials across service accounts, OAuth tokens, and regions, which is error-prone when done manually.

Core Features & Use Cases

  • Dependency Installation: Installs mixpanel_headless, pandas, numpy, matplotlib, seaborn, networkx, anytree, scipy, and pyarrow on Python 3.11+ using uv or pip.
  • Credential Verification: Checks service-account environment variables, OAuth bearer tokens, and persisted accounts in ~/.mp/config.toml, then reports session state as ok, needs_account, needs_project, or error.
  • Remote Session Support: Detects sandboxed environments and guides users to export an auth bridge file from their host machine for credential access.
  • Use Case: A data analyst starting Mixpanel event analysis in a fresh environment runs the setup script to install all libraries, then runs mp login to authenticate and confirms the connection with an account test.

Quick Start

Ask the assistant to set up the Mixpanel analytics environment and verify that credentials are configured correctly.

Frequently Asked Questions about mixpanel-headless-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Mixpanel credentials for Python analytics?

Run mp login for a one-shot flow that picks the right auth method for your environment, or set the MP_USERNAME, MP_SECRET, MP_PROJECT_ID, and MP_REGION environment variables for service-account access. OAuth bearer tokens work via MP_OAUTH_TOKEN for non-interactive contexts.

How to install mixpanel_headless and its dependencies?

Run the bundled setup.sh script, which detects Python 3.10+ and installs mixpanel_headless, pandas, numpy, matplotlib, seaborn, networkx, anytree, scipy, and pyarrow on Python 3.11+. It tries uv first and falls back to pip.

Can I use Mixpanel authentication in a remote or sandboxed session?

Interactive OAuth login is not available in remote sessions. Run mp account export-bridge --to ~/.claude/mixpanel/auth.json on your host machine, then start a new remote session so credentials load automatically.

Why does Mixpanel setup report needs_project after login?

The needs_project state means an account is configured but no project is pinned. Run mp project list to see accessible projects, then mp project use <id> to select one before running analytics queries.

What Python version is required for mixpanel_headless?

Python 3.10 or newer is required, and the setup script exits if no suitable interpreter is found. On Python 3.11+, pyarrow 17.0+ is also installed to support pandas 3.x Arrow-backed dtypes.