X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Amplitude to Claude

Connect Claude Web, Desktop and Cowork to Amplitude MCP. Get daily active users for last month, generate funnel analysis for onboarding flow, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Amplitude logoAmplitude
Api Key

Amplitude is a digital analytics platform for product and behavioral data insights. It helps teams analyze user journeys and make data-driven decisions quickly.

54 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Amplitude account to Claude via Composio Connect, enabling it to get daily active users for last month, generate funnel analysis for onboarding flow, list top events for premium users, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Amplitude with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Amplitude to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Amplitude account

Back in Claude, ask it to connect to Amplitude or give it any Amplitude-related task.

For example, ask Claude to:

  • "Get daily active users for last month"
  • "Generate funnel analysis for onboarding flow"
  • "List top events for premium users"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Amplitude account is ready to use.

What is the Amplitude Claude Connector, and what's possible with it?

The Amplitude MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Amplitude account. It provides structured and secure access to your analytics platform, so your agent can perform actions like managing event types, organizing cohorts, updating user properties, and tracking event categories on your behalf.

  • Cohort and user management: Ask your agent to request, download, and check the status of specific user cohorts for advanced segmentation or analysis.
  • Event type and category administration: Effortlessly create, update, or delete event types and categories, keeping your analytics taxonomy organized and up to date.
  • User property updates: Direct your agent to set or modify user properties—like device information or location—without sending new events, making user profile management a breeze.
  • Comprehensive analytics lookup: Retrieve detailed information about event types and categories, enabling your agent to provide insights or answer analytics questions in real time.

Troubleshooting

1. Why does Claude not use the Composio connector for Amplitude?

The connector can show as connected, but Claude must use it in each Amplitude conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Amplitude again.

2. Why does Claude show an MCP server error before Amplitude connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Amplitude.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Amplitude.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Amplitude authorization link not work?

The Composio connector is one server. Your Amplitude account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Amplitude connection.
  • Composio creates a fresh Amplitude authorization link.
  • Open that link in your browser and finish the Amplitude sign-in.

4. Why do Amplitude actions fail after they worked before?

The Amplitude connection can expire or lose permission.

  • Ask Claude to inspect the Amplitude connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Amplitude account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Amplitude.
  • If the action still fails with a permission error, check that the connected account has that permission in Amplitude itself.

5. How do I switch to a different Amplitude account?

Claude can manage the Amplitude connection for you.

  • Ask Claude to disconnect or delete the current Amplitude account.
  • Ask Claude to connect Amplitude again.
  • Open the new Composio authorization link for Amplitude.
  • Sign in with the other Amplitude account in the browser.
  • After the account connects, ask Claude to retry the Amplitude task.

6. Why is my Amplitude connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Amplitude connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Amplitude tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Amplitude.
TOOLS

Supported Tools

Every Amplitude action and event your agent gets out of the box.

Bulk Assign Annotations to Category

Tool to bulk assign multiple annotations to a category in Amplitude.

Cancel User Deletion

Cancel a pending user deletion request in Amplitude.

Check Amplitude Cohort Status

Check the status of a cohort export request.

Create Chart Annotation in Amplitude

Create a chart annotation in Amplitude to mark important dates.

Create Annotation Category

Tool to create an annotation category in Amplitude to organize annotations.

Create Amplitude Event Category

Create a new event category in Amplitude.

Create Amplitude Event Type

Create a new event type in Amplitude.

Create Amplitude Release

Create a release to document product changes.

Delete Amplitude Chart Annotation

Delete a chart annotation from Amplitude.

Delete Amplitude Annotation Category

Delete an annotation category from Amplitude.

Delete Amplitude Event Category

Delete an event category from Amplitude.

Delete Amplitude Event Type

Delete an event type from Amplitude.

Delete Amplitude Users

Submit user deletion requests for GDPR/CCPA compliance.

Download Amplitude Cohort File

Download the cohort file after request is complete.

Search Amplitude User

Search for users in Amplitude by canonical identifier (Amplitude ID, device ID, user ID, or user ID prefix).

Get Active or New Users

Get the number of active or new users for a date range with optional segmentation.

Get Amplitude Annotation

Get a single chart annotation by ID from Amplitude.

Get Amplitude Annotation Category

Get a single annotation category by ID from Amplitude.

Request Amplitude Cohort

Get a single cohort by ID and initiate download.

Get User Deletion Requests

Get the status of user deletion requests within a date range.

Get Amplitude Event Categories

Get event categories from Amplitude.

Get Amplitude Event Property

Get a specific event property from Amplitude taxonomy.

Get Event Segmentation Data

Get event segmentation data from Amplitude Analytics API.

Get Amplitude Event Type

Get a specific event type from Amplitude by name.

Get Amplitude Event Types

Get all event types from Amplitude.

Get Funnel Analysis Data

Get funnel analysis data showing user conversion through a sequence of events.

Get Real-time Active Users

Get real-time active users count from Amplitude.

Get User Retention Analysis

Get user retention analysis showing how users return over time after a starting action.

Get Revenue LTV Metrics

Get revenue lifetime value (LTV) metrics including ARPU, ARPPU, and total revenue.

Get Session Average Length

Get average session length (in seconds) for a specified date range from Amplitude.

Get Session Length Distribution

Tool to retrieve session length distribution data for a specified date range from Amplitude.

Get Sessions Per User from Amplitude

Tool to get average number of sessions per user for each day in a date range from Amplitude.

Get User Activity from Amplitude

Fetch a single user's profile summary and event stream by Amplitude ID.

Get User Composition by Property

Tool to get user composition breakdown by property (platform, version, country, etc.

Get User Mappings

Get the list of user mappings for provided user IDs.

Get Amplitude User Property

Get a specific user property from Amplitude taxonomy.

Update User Properties in Amplitude

Update user properties using Amplitude's Identify API.

List Amplitude Annotation Categories

List all annotation categories from Amplitude.

List Chart Annotations

Tool to get all chart annotations with optional filtering by category, chart, and date range.

List Amplitude Cohorts

List all discoverable cohorts for an Amplitude project.

List Amplitude Event Properties

Get all event properties from Amplitude, optionally filtered by event type or property name.

List Amplitude Events

Tool to get a list of all event types in your Amplitude project with current week's statistics.

List Amplitude User Properties

Tool to get all user properties in your Amplitude project.

Map Users in Amplitude

Map users with different user IDs together (alias/merge users) in Amplitude.

Restore Amplitude Event Type

Restore a deleted event type in Amplitude.

Send Events to Amplitude

Send events to Amplitude using the HTTP V2 API.

Set Group Properties in Amplitude

Set group properties for account-level reporting without sending an event.

Update Amplitude Chart Annotation

Tool to update an existing chart annotation in Amplitude.

Update Amplitude Annotation Category

Tool to update an annotation category in Amplitude.

Update Amplitude Cohort Membership

Incrementally update cohort membership by adding or removing IDs.

Update Amplitude Event Category

Update an existing event category in Amplitude.

Update Amplitude Event Type

Update an existing event type in Amplitude.

Batch Upload Events to Amplitude

Bulk upload events to Amplitude using the Batch Event Upload API.

Upload Amplitude Cohort

Generate a new cohort or update an existing cohort by uploading user IDs or Amplitude IDs.

FRAMEWORKS

How to build Amplitude MCP Agent with another framework

Claude Code logo

Claude Code

Use Amplitude MCP with Claude Code

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Amplitude MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Amplitude MCP with Claude Agent SDK

Codex logo

Codex

Use Amplitude MCP with Codex

OpenClaw logo

OpenClaw

Use Amplitude MCP with OpenClaw

Hermes logo

Hermes

Use Amplitude MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Amplitude MCP with Atomic Agent

Google ADK logo

Google ADK

Use Amplitude MCP with Google ADK

LangChain logo

LangChain

Use Amplitude MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Amplitude MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Amplitude MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Amplitude MCP with LlamaIndex

CrewAI logo

CrewAI

Use Amplitude MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Amplitude MCP with Pydantic AI

AutoGen logo

AutoGen

Use Amplitude MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Amplitude MCP server, the agents and LLMs can only access a fixed set of Amplitude tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Amplitude and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Amplitude tools.

Yes, absolutely. You can configure which Amplitude scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Amplitude data and credentials are handled as safely as possible.

Start with Amplitude.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Amplitude tool your agent needs.Free to start.

Start building