# How to integrate Amplitude MCP with Hermes ```json { "title": "How to integrate Amplitude MCP with Hermes", "toolkit": "Amplitude", "toolkit_slug": "amplitude", "framework": "Hermes", "framework_slug": "hermes-agent", "url": "https://composio.dev/toolkits/amplitude/framework/hermes-agent", "markdown_url": "https://composio.dev/toolkits/amplitude/framework/hermes-agent.md", "updated_at": "2026-05-06T08:00:29.385Z" } ``` ## 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 with - [OpenAI Agents SDK](https://composio.dev/toolkits/amplitude/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/amplitude/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/amplitude/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/amplitude/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/amplitude/framework/codex) - [OpenClaw](https://composio.dev/toolkits/amplitude/framework/openclaw) - [CLI](https://composio.dev/toolkits/amplitude/framework/cli) - [Google ADK](https://composio.dev/toolkits/amplitude/framework/google-adk) - [LangChain](https://composio.dev/toolkits/amplitude/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/amplitude/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/amplitude/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/amplitude/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/amplitude/framework/crew-ai) ## TL;DR ### What is Composio Connect? Composio Connect is a consumer offering that lets anyone plug 1,000+ 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. ## Connect Amplitude to Hermes ### 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 ``` ## 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 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. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `AMPLITUDE_CHECK_COHORT_STATUS` | Check Amplitude Cohort Status | Check the status of a cohort export request. this action allows you to: - poll the status of an in-progress cohort download request - determine if a cohort is ready for download | | `AMPLITUDE_CREATE_EVENT_CATEGORY` | Create Amplitude Event Category | Create a new event category in amplitude. this action allows you to: - create a new event category to organize event types - validate category name before creation key features: - creates event categories for organizing events - returns success/failure status | | `AMPLITUDE_CREATE_EVENT_TYPE` | Create Amplitude Event Type | Create a new event type in amplitude. this action allows you to: - define a new event type with various properties - associate the event with a category - add metadata like description, tags, and owner key features: - creates trackable events in your amplitude project - supports full event type configuration | | `AMPLITUDE_DELETE_EVENT_CATEGORY` | Delete Amplitude Event Category | Delete an event category from amplitude. this action allows you to: - delete an existing event category - remove category organization from events key features: - permanently removes event categories - returns success/failure status | | `AMPLITUDE_DELETE_EVENT_TYPE` | Delete Amplitude Event Type | Delete an event type from amplitude. this action allows you to: - remove an event type from your project - mark live events as deleted - remove planned events from the tracking plan key features: - different behavior based on event status (live, planned, etc.) - returns success/failure status | | `AMPLITUDE_GET_COHORT` | Request Amplitude Cohort | Get a single cohort by id and initiate download. this action allows you to: - request a specific cohort from amplitude - optionally include user properties in the response - start the asynchronous download process key features: - supports filtering by specific user properties - returns a request id used for polling status and downloading - supports eu data residency | | `AMPLITUDE_GET_EVENT_CATEGORIES` | Get Amplitude Event Categories | Get event categories from amplitude. this action allows you to: - get all event categories in your project - get a specific category by name | | `AMPLITUDE_GET_EVENT_TYPE` | Get Amplitude Event Type | Get a specific event type from amplitude by name. this action allows you to: - retrieve detailed information about a single event type - get all properties and metadata for the event key features: - retrieves comprehensive event type details - returns metadata like category, description, and settings - supports lookup by exact event name | | `AMPLITUDE_GET_EVENT_TYPES` | Get Amplitude Event Types | Get all event types from amplitude. this action allows you to: - retrieve all event types in your project - optionally include deleted events | | `AMPLITUDE_IDENTIFY` | Update User Properties in Amplitude | Update user properties using amplitude's identify api. this action allows you to: - set or update the user id for a device id - update user properties without sending an event - perform operations on user properties (set, append, etc.) - update user attributes like device info and location | | `AMPLITUDE_LIST_COHORTS` | List Amplitude Cohorts | List all discoverable cohorts for an amplitude project. this action allows you to: - get a list of all cohorts in your amplitude project - optionally include sync information for each cohort key features: - returns cohort details including id, name, size, and definition - optionally includes sync metadata for integration with other tools - supports eu data residency | | `AMPLITUDE_RESTORE_EVENT_TYPE` | Restore Amplitude Event Type | Restore a deleted event type in amplitude. this action allows you to: - restore a previously deleted event type - make the event available again in the ui and api key features: - undoes the deletion of an event type - returns success/failure status | | `AMPLITUDE_SEND_EVENTS` | Send Events to Amplitude | Send events to amplitude using the http v2 api. this action allows you to send events to amplitude for tracking user behavior and analytics. it supports all amplitude event fields, handles proper validation, and includes comprehensive error handling. | | `AMPLITUDE_UPDATE_COHORT_MEMBERSHIP` | Update Amplitude Cohort Membership | Incrementally update cohort membership by adding or removing ids. this action allows you to: - add new ids to an existing cohort - remove ids from an existing cohort - perform multiple operations in a single request | | `AMPLITUDE_UPDATE_EVENT_CATEGORY` | Update Amplitude Event Category | Update an existing event category in amplitude. this action allows you to: - update the name of an existing event category - validate the new category name key features: - updates category names - returns success/failure status | | `AMPLITUDE_UPDATE_EVENT_TYPE` | Update Amplitude Event Type | Update an existing event type in amplitude. this action allows you to: - change event type properties - update event name, category, metadata, and settings - modify display name for ingested events key features: - updates event type configuration - supports partial updates (only specified fields are changed) | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Amplitude MCP server provides comprehensive access to Amplitude operations through Composio. Once connected, Hermes can perform all major Amplitude actions on your behalf using natural language commands. ## Complete Code None listed. ## Conclusion ### 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](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options. ## How to build Amplitude MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/amplitude/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/amplitude/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/amplitude/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/amplitude/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/amplitude/framework/codex) - [OpenClaw](https://composio.dev/toolkits/amplitude/framework/openclaw) - [CLI](https://composio.dev/toolkits/amplitude/framework/cli) - [Google ADK](https://composio.dev/toolkits/amplitude/framework/google-adk) - [LangChain](https://composio.dev/toolkits/amplitude/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/amplitude/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/amplitude/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/amplitude/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/amplitude/framework/crew-ai) ## Related Toolkits - [Firecrawl](https://composio.dev/toolkits/firecrawl) - Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources. - [Tavily](https://composio.dev/toolkits/tavily) - Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research. - [Exa](https://composio.dev/toolkits/exa) - Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows. - [Serpapi](https://composio.dev/toolkits/serpapi) - SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research. - [Peopledatalabs](https://composio.dev/toolkits/peopledatalabs) - Peopledatalabs delivers B2B data enrichment and identity resolution APIs. Supercharge your apps with accurate, up-to-date business and contact data. - [Snowflake](https://composio.dev/toolkits/snowflake) - Snowflake is a cloud data warehouse built for elastic scaling, secure data sharing, and fast SQL analytics across major clouds. - [Posthog](https://composio.dev/toolkits/posthog) - PostHog is an open-source analytics platform for tracking user interactions and product metrics. It helps teams refine features, analyze funnels, and reduce churn with actionable insights. - [Bright Data MCP](https://composio.dev/toolkits/brightdata_mcp) - Bright Data MCP is an AI-powered web scraping and data collection platform. Instantly access public web data in real time with advanced scraping tools. - [Browseai](https://composio.dev/toolkits/browseai) - Browseai is a web automation and data extraction platform that turns any website into an API. It's perfect for monitoring websites and retrieving structured data without manual scraping. - [ClickHouse](https://composio.dev/toolkits/clickhouse) - ClickHouse is an open-source, column-oriented database for real-time analytics and big data processing using SQL. Its lightning-fast query performance makes it ideal for handling large datasets and delivering instant insights. - [Coinmarketcal](https://composio.dev/toolkits/coinmarketcal) - CoinMarketCal is a community-powered crypto calendar for upcoming events, announcements, and releases. It helps traders track market-moving developments and stay ahead in the crypto space. - [Control d](https://composio.dev/toolkits/control_d) - Control d is a customizable DNS filtering and traffic redirection platform. It helps you manage internet access, enforce policies, and monitor usage across devices and networks. - [Databox](https://composio.dev/toolkits/databox) - Databox is a business analytics platform that connects your data from any tool and device. It helps you track KPIs, build dashboards, and discover actionable insights. - [Databricks](https://composio.dev/toolkits/databricks) - Databricks is a unified analytics platform for big data and AI on the lakehouse architecture. It empowers data teams to collaborate, analyze, and build scalable solutions efficiently. - [Datagma](https://composio.dev/toolkits/datagma) - Datagma delivers data intelligence and analytics for business growth and market discovery. Get actionable market insights and track competitors to inform your strategy. - [Delighted](https://composio.dev/toolkits/delighted) - Delighted is a customer feedback platform based on the Net Promoter System®. It helps you quickly gather, track, and act on customer sentiment. - [Dovetail](https://composio.dev/toolkits/dovetail) - Dovetail is a research analysis platform for transcript review and insight generation. It helps teams code interviews, analyze feedback, and create actionable research summaries. - [Dub](https://composio.dev/toolkits/dub) - Dub is a short link management platform with analytics and API access. Use it to easily create, manage, and track branded short links for your business. - [Elasticsearch](https://composio.dev/toolkits/elasticsearch) - Elasticsearch is a distributed, RESTful search and analytics engine for all types of data. It delivers fast, scalable search and powerful analytics across massive datasets. - [Fireflies](https://composio.dev/toolkits/fireflies) - Fireflies.ai is an AI-powered meeting assistant that records, transcribes, and analyzes voice conversations. It helps teams capture call notes automatically and search or summarize meetings effortlessly. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Amplitude MCP? 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. ### Can I use Tool Router MCP with Hermes? 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. ### Can I manage the permissions and scopes for Amplitude while using Tool Router? 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. ### How safe is my data with Composio Tool Router? 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. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)