Labsco
moonbirdai logo

Mixpanel MCP Server

★ 5

from moonbirdai

Integrate Mixpanel analytics into your AI workflows.

🔥🔥🔥✓ VerifiedFreeAdvanced setup
#email#automation#analytics#git#security

Mixpanel MCP Server

A Model Context Protocol (MCP) server for integrating Mixpanel analytics into AI workflows. This server allows AI assistants like Claude to track events, page views, user signups, and update user profiles in Mixpanel.

Version 2.0.1 Note: Tool names now include the mixpanel_ prefix to prevent namespace collisions with other analytics MCP servers.

Table of Contents

Features

  • Track custom events in Mixpanel
  • Track page views with referrer information
  • Track user signups and create user profiles
  • Update existing user profiles
  • Simple integration with Claude Desktop and other MCP clients

Tool Reference

The Mixpanel MCP server provides the following tools:

mixpanel_track_event

Tracks a custom event in Mixpanel.

Parameters:

  • event_name (string, required): The name of the event to track
  • distinct_id (string, optional): User identifier. Defaults to 'anonymous'
  • properties (object, optional): Additional properties to track with the event

Example:

{
  "event_name": "button_clicked",
  "distinct_id": "user123",
  "properties": {
    "button_id": "submit_form",
    "page": "checkout"
  }
}

mixpanel_track_pageview

Tracks a page view event in Mixpanel.

Parameters:

  • page_name (string, required): The name of the page viewed
  • distinct_id (string, optional): User identifier. Defaults to 'anonymous'
  • referrer (string, optional): The referring page

Example:

{
  "page_name": "homepage",
  "distinct_id": "user123",
  "referrer": "google.com"
}

mixpanel_track_signup

Tracks a signup event and creates a user profile in Mixpanel.

Parameters:

  • user_name (string, required): User's full name
  • email (string, required): User's email address
  • plan (string, optional): Signup plan. Defaults to 'free'

Example:

{
  "user_name": "John Doe",
  "email": "john@example.com",
  "plan": "premium"
}

mixpanel_set_user_profile

Updates a user's profile properties in Mixpanel.

Parameters:

  • distinct_id (string, required): User identifier
  • properties (object, required): Profile properties to set

Example:

{
  "distinct_id": "user123",
  "properties": {
    "$name": "John Doe",
    "$email": "john@example.com",
    "plan": "premium",
    "company": "Acme Inc"
  }
}

Examples

Here are some practical examples of using the Mixpanel MCP server with Claude:

Tracking a Button Click

You: Can you track an event in Mixpanel when a user clicks the submit button?

Claude: I'll track that event for you. Let me use the Mixpanel analytics tool.

[Claude uses the mixpanel_track_event tool with appropriate parameters]

Claude: I've successfully tracked the 'button_clicked' event in Mixpanel with the properties you specified.

Creating a User Profile

You: Create a new user profile in Mixpanel for Sarah Johnson who signed up with sarah@example.com on the premium plan.

Claude: I'll create that user profile in Mixpanel.

[Claude uses the mixpanel_track_signup tool with appropriate parameters]

Claude: I've successfully tracked the signup for Sarah Johnson and created a profile in Mixpanel with the premium plan.

Security Notes

  • Your Mixpanel token is stored in the Claude Desktop configuration file. Ensure this file has appropriate permissions
  • Consider using environment variables for sensitive tokens in production environments
  • This server does not implement rate limiting - consider adding additional security measures for production use
  • Events are sent directly to Mixpanel's API - review Mixpanel's privacy policy for data handling practices

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.