X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Amplitude MCP to Claude

Connect Claude Web, Desktop and Cowork to Amplitude MCP. List all cohorts created this month, create dashboard with retention and revenue charts, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Amplitude MCP logoAmplitude MCP
Dcr Oauth

Amplitude MCP is Amplitude's product analytics service for tracking user behavior and product metrics. Use it to centralize product data and manage charts, dashboards, cohorts, experiments, and taxonomy.

48 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 list all cohorts created this month, create dashboard with retention and revenue charts, run experiment analysis for signup conversion funnel, 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 MCP with

ChatGPTHermesAtomic Agent

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:

  • "List all cohorts created this month"
  • "Create dashboard with retention and revenue charts"
  • "Run experiment analysis for signup conversion funnel"

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 so your agent can perform Amplitude operations on your behalf.

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 MCP action and event your agent gets out of the box.

Create group types

Create one or more group types in a project, OR add already-ingested group types with status "unexpected" to the tracking plan.

Create properties

Create one or more properties in a project's tracking plan.

Delete event properties

Delete one or more event properties in a project.

Delete user properties

Delete one or more user properties in a project.

Get agent results

Retrieve results from AI agents that have analyzed your dashboards or session replays.

Get amplitude agent analytics info

Single read entry point for Amplitude Agent Analytics (AI/LLM session investigation).

Get amplitude charts

Read saved Amplitude charts by ID, or look up the chart-type schema.

Get amplitude context

Unified entry point for Amplitude context.

Get amp session replay info

Unified entry point for session replay data: find replays and inspect what happened in them.

Get amp taxonomy

Read a project's tracking plan: the events it defines, the properties on them, what a branch changes relative to main, and who changed what when.

Get amp user data

Look up Amplitude users.

Get data warehouse destinations

List the Data Warehouse export destinations configured for a project.

Get from url

Retrieve objects from Amplitude URLs WHEN TO USE: - CRITICAL: Only use this tool for full Amplitude app URLs on supported hosts (app.

Get group types

List available group types for a project.

Get session replay duration

APP SUPPORT ONLY.

Get session replay stream

APP SUPPORT ONLY.

Get session replay timeline

APP SUPPORT ONLY.

Get tracking plan sources

List the sources configured on a project's tracking plan (e.

Get transformations

Retrieve data transformations from a project.

Manage amp context

Manage AI context.

Manage amp entities

Create a shared (team) space, rename a space or change its members, or move charts, dashboards, notebooks, or cohorts into a shared space.

Manage amp events

Write to a project's tracking-plan events — raw ingested events, custom events, and labeled (autotrack) events — in one tool selected by `action` + `kind`.

Manage amp taxonomy

Read Data workspace governance settings and manage tracking-plan branches for a project.

Query amplitude data

Run analytics queries to answer data questions about users, events, funnels, and retention — and to create or modify charts via the typed `chart` parameter.

Rename chart

Rename a chart that has already been saved WHEN TO USE: - A chart was saved (e.

Render amplitude chart

Render an interactive Amplitude chart UI for a saved chart or a chart edit by ID.

Render amp session replay

Render an interactive session replay player UI for one or more session replays.

Restore event properties

Restore event properties that were previously marked as deleted in a project.

Restore user properties

Restore user properties that were previously marked as deleted in a project.

Save chart edits

Promote chart edits to saved charts — Save as (new chartId) or Save in place (same chartId).

Search amp data taxonomy

Semantic search over a project's data taxonomy: discover events, properties, and property values by describing what you're looking for in natural language.

Search amp entities

Search for dashboards, charts, notebooks, experiments, docs, and other content in Amplitude.

Share amp entities

Manage sharing and org invites for Amplitude entities.

Track ui render response

Internal telemetry tool used by MCP UI components to report render latency and errors.

Update properties

Update property description, isOfficial, category, and/or name in a project's tracking plan.

Use amp ai visibility

Use Amplitude AI Visibility.

Use amp comments

Read and add plain-text comments on Amplitude charts, dashboards, and notebooks.

Use amp dashboards

Read and manage Amplitude dashboards.

Use amp experiments

Unified entry point for experiments: read, analyze, create, and set metrics.

Use amp flags

Unified entry point for feature flags and deployments.

Use amp guides surveys

List Guides and Surveys or get one by ID.

Use amplitude ai feedback

Read Amplitude AI Feedback (customer VoC) for a project — surveys, support tickets, app reviews, and grouped themes.

Use amplitude chart monitors

Read and manage chart alert monitors.

Use amplitude cohorts

Work with Amplitude cohorts end to end.

Use amplitude data connections

Unified entry point for everything to do with a project's data connections — ingestion sources, import/export job history, Snowflake credentials, live Snowflake warehouse browsing, and Amplitude import-config recommendations.

Use amplitude metrics

Unified entry point for metric definitions, goals, and goal alerts in a project.

Use amp notebooks

Read and manage Amplitude notebooks.

Use amp skill

Load an Amplitude skill — a workflow playbook describing the optimal sequence of Amplitude tools for a task.

FRAMEWORKS

How to build Amplitude MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Amplitude MCP with ChatGPT

Hermes logo

Hermes

Use Amplitude MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Amplitude MCP with Atomic Agent

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 MCP.It takes 30 seconds.

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

Start building