X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Amplitude MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Amplitude account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Amplitude MCP with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Amplitude with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Amplitude

Ask your agent to connect to Amplitude, or simply request any Amplitude-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Amplitude connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Amplitude or request any Amplitude-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Amplitude MCP server, 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.

Way Forward

With Amplitude connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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

Claude Cowork logo

Claude Cowork

Use Amplitude MCP with Claude Cowork

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. Hermes 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