Amplitude 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 Amplitude

• Track page views with properties

• Track user signups and create user profiles

• Update existing user properties

• Track revenue and purchases

• Simple integration with Claude Desktop and other MCP clients

Installation

Prerequisites

• Node.js 16 or higher

• An Amplitude API key (get one by signing up at [Amplitude](https://amplitude.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 Amplitude MCP server configuration:

1. Restart Claude Desktop and start tracking analytics!

Detailed Usage

With Claude Desktop

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

• "Track a page view for the pricing page in Amplitude"

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

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

• "Track a purchase of Product X for $49.99"

With Other MCP Clients

1. Start the server: ```bash npx amplitude-mcp-server --api-key YOUR_AMPLITUDE_API_KEY ```

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

3. The client can discover and use the available tools (track_event, track_pageview, track_signup, set_user_properties, track_revenue)

Tool Reference

amplitude_track_event

• `event_name` (string, required): The name of the event to track

• `user_id` (string, optional): User identifier

• `device_id` (string, optional): Device identifier

• `properties` (object, optional): Additional properties to track with the event

• `user_properties` (object, optional): User properties to update with this event

amplitude_track_pageview

• `page_name` (string, required): The name of the page viewed

• `user_id` (string, optional): User identifier

• `device_id` (string, optional): Device identifier

• `properties` (object, optional): Additional properties to track with the event

amplitude_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'

amplitude_set_user_properties

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

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

amplitude_track_revenue

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

• `product_id` (string, required): Identifier for the product purchased

• `price` (number, required): Price of the item purchased

• `quantity` (number, optional): Quantity of items purchased. Defaults to 1

• `revenue_type` (string, optional): Type of revenue (e.g., 'purchase', 'refund', 'subscription')

Examples

Tracking a Button Click

Creating a User Profile

Tracking Revenue

Troubleshooting

Common Issues

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

2. **Claude Desktop not showing Amplitude 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 Amplitude:** - Verify your Amplitude API key is correct - Check your Amplitude project settings to ensure data is being received - Events may take a few minutes to appear in the Amplitude interface

Debug Mode

Security Notes

• Your Amplitude API key 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 Amplitude's API - review Amplitude'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