amplitude

The Amplitude MCP Server integrates Amplitude analytics into your AI workflows via the Model Context Protocol (MCP). It exposes tools that let you track custom events, page views, user signups (with profile creation), update user properties, and record revenue events directly from your MCP client or Claude-like assistants. The server is designed to be discoverable by MCP clients and can be invoked via standard MCP transport (stdio) using the amplitude_track_event, amplitude_track_pageview, amplitude_track_signup, amplitude_set_user_properties, and amplitude_track_revenue tools. Use these tools to instrument conversations and automations with analytics data that lands in your Amplitude project for insights, dashboards, and downstream actions.

Prerequisites:

• Node.js 16 or higher
• An Amplitude API key

Installation steps (recommended):

# Install globally (optional but convenient)
npm install -g amplitude-mcp-server

# Or run directly with npx (no global install)
npx amplitude-mcp-server --api-key YOUR_AMPLITUDE_API_KEY

Manual installation (from source):

# Clone the repository
git clone https://github.com/ciaraadkins/amplitude-mcp-server.git
cd amplitude-mcp-server

# Install dependencies
npm install

# Run the server
node index.js --api-key YOUR_AMPLITUDE_API_KEY

Note: Replace YOUR_AMPLITUDE_API_KEY with your actual Amplitude API key. You can also configure the server to use an environment variable if preferred, e.g. AMPLITUDE_API_KEY.

Tips and notes:

• The tool names in Version 1.0.1 include the amplitude_ prefix to avoid namespace collisions with other MCP servers.
• When using Claude Desktop, ensure the configuration file exposes the amplitude-analytics server under mcpServers to enable discovery of tools.
• If the server doesn't appear in your MCP client, verify the API key is valid and that the server is reachable from your environment.
• Common issues include Node.js version mismatches, invalid JSON configuration in Claude/Claude Desktop, or incorrect API key scoping in Amplitude (e.g., ensuring data is sent to the correct project).
• The available tools are:
  • amplitude_track_event
  • amplitude_track_pageview
  • amplitude_track_signup
  • amplitude_set_user_properties
  • amplitude_track_revenue