Mixpanel MCP Server

Table of Contents

• [Features](#features)

• [Installation](#installation)

• [Quick Start](#quick-start)

• [Detailed Usage](#detailed-usage) - [With Claude Desktop](#with-claude-desktop) - [With Other MCP Clients](#with-other-mcp-clients)

• [Tool Reference](#tool-reference)

• [Examples](#examples)

• [Troubleshooting](#troubleshooting)

• [Security Notes](#security-notes)

• [Contributing](#contributing)

• [License](#license)

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

Installation

Prerequisites

• Node.js 16 or higher

• A Mixpanel project token (get one by signing up at [Mixpanel](https://mixpanel.com))

NPM Installation (Recommended)

Manual Installation

Quick Start

1. Make sure Claude Desktop is installed on your machine (download from [claude.ai/download](https://claude.ai/download))

2. Create or edit the Claude Desktop configuration file: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%AppData%\Claude\claude_desktop_config.json`

3. Add the Mixpanel MCP server configuration:

1. Restart Claude Desktop and start tracking analytics!

Detailed Usage

With Claude Desktop

• "Track a custom event in Mixpanel named 'document_generated' for user 'user123'"

• "Track a page view for the homepage in Mixpanel"

• "Create a new user profile in Mixpanel for John Doe with email john@example.com"

• "Update user profile information in Mixpanel for user 'user123'"

With Other MCP Clients

1. Start the server: ```bash npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN ```

2. Connect your MCP client to the server using stdio transport

3. The client can discover and use the available tools (mixpanel_track_event, mixpanel_track_pageview, mixpanel_track_signup, mixpanel_set_user_profile)

Tool Reference

mixpanel_track_event

• `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

mixpanel_track_pageview

• `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

mixpanel_track_signup

• `user_name` (string, required): User's full name

• `email` (string, required): User's email address

• `plan` (string, optional): Signup plan. Defaults to 'free'

mixpanel_set_user_profile

• `distinct_id` (string, required): User identifier

• `properties` (object, required): Profile properties to set

Examples

Tracking a Button Click

Creating a User Profile

Troubleshooting

Common Issues

1. **Server not starting:** - Ensure you've provided a valid Mixpanel token - Check that Node.js is installed and is version 16 or higher

2. **Claude Desktop not showing Mixpanel tools:** - Verify your claude_desktop_config.json file syntax - Make sure you've restarted Claude Desktop after editing the config - Check that the path to the server is correct

3. **Events not appearing in Mixpanel:** - Verify your Mixpanel token is correct - Check your Mixpanel project settings to ensure data is being received - Events may take a few minutes to appear in the Mixpanel interface

Debug Mode

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

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