# How to integrate Vapi MCP with Hermes ```json { "title": "How to integrate Vapi MCP with Hermes", "toolkit": "Vapi", "toolkit_slug": "vapi", "framework": "Hermes", "framework_slug": "hermes-agent", "url": "https://composio.dev/toolkits/vapi/framework/hermes-agent", "markdown_url": "https://composio.dev/toolkits/vapi/framework/hermes-agent.md", "updated_at": "2026-03-29T06:54:31.728Z" } ``` ## 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 Vapi 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 Vapi with - [OpenAI Agents SDK](https://composio.dev/toolkits/vapi/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/vapi/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/vapi/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/vapi/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/vapi/framework/codex) - [OpenClaw](https://composio.dev/toolkits/vapi/framework/openclaw) - [CLI](https://composio.dev/toolkits/vapi/framework/cli) - [Google ADK](https://composio.dev/toolkits/vapi/framework/google-adk) - [LangChain](https://composio.dev/toolkits/vapi/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/vapi/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/vapi/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/vapi/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/vapi/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 Vapi to Hermes ### Integrating Vapi 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 Vapi MCP server, and what's possible with it? The Vapi MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Vapi account. It provides structured and secure access so your agent can perform Vapi operations on your behalf. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `VAPI_ASSISTANT_CONTROLLER_UPDATE` | Update Assistant | Tool to update an existing Vapi assistant configuration. Use when you need to modify assistant properties such as name, voice settings, transcriber configuration, model settings, messages, or other behavior parameters. Only include fields you want to update. | | `VAPI_CALL_CONTROLLER_FIND_ALL` | List Calls | Tool to list calls from Vapi. Use when you need to retrieve multiple calls with optional filtering by id, assistantId, phoneNumberId, or date ranges. Returns an array of call objects with details including status, costs, messages, and artifacts. | | `VAPI_CHAT_CONTROLLER_DELETE_CHAT` | Delete Chat | Tool to delete a chat by its ID from Vapi. Use when you need to permanently remove a chat conversation. | | `VAPI_CHAT_CONTROLLER_GET_CHAT` | Get Chat | Tool to fetch chat details by ID. Use when you have a chat ID and need full chat information including messages, costs, and configuration. | | `VAPI_CREATE_ANALYTICS_QUERIES` | Create Analytics Queries | Tool to create and execute analytics queries on VAPI data. Use when you need to analyze call or subscription metrics with aggregations like count, sum, average, min, or max. Supports grouping by various dimensions and time-based analysis with custom time ranges. | | `VAPI_CREATE_ASSISTANT` | Create Assistant | Tool to create a new Vapi assistant with specified transcriber, voice, and AI model configurations. Use when setting up a conversational AI assistant for voice interactions. The assistant requires transcription (speech-to-text), voice (text-to-speech), and AI model (conversation logic) configurations at minimum. | | `VAPI_CREATE_EVAL` | Create Eval | Tool to create an eval for testing conversation flows. Use when you need to validate that an AI assistant responds correctly to specific conversation scenarios. | | `VAPI_CREATE_OPENAI_CHAT` | Create OpenAI Chat | Tool to create an OpenAI-compatible chat using the Vapi API. Use when you need to send a chat message to an assistant or squad and receive a response. Supports both streaming and non-streaming modes. | | `VAPI_CREATE_PHONE_NUMBER` | Create Phone Number | Tool to create a phone number with Vapi. Supports multiple providers including byo-phone-number, twilio, vonage, vapi, and telnyx. Use this to provision new phone numbers for handling voice calls. For vapi provider, only provider field is required; other fields are optional based on provider type. | | `VAPI_CREATE_MONITORING_POLICY` | Create Monitoring Policy | Tool to create a monitoring policy in VAPI. Use when you need to set up automated monitoring rules based on thresholds and time windows. Policies can trigger alerts based on event counts or percentages over a specified lookback window. | | `VAPI_CREATE_PROVIDER_RESOURCE` | Create Provider Resource | Tool to create an 11Labs pronunciation dictionary resource. Use when you need to define custom pronunciations for specific terms or acronyms in voice synthesis. | | `VAPI_CREATE_SCORECARD` | Create Scorecard | Tool to create a scorecard for observability and evaluation. Use when setting up metrics to evaluate assistant performance based on structured outputs. Scorecards contain metrics with conditions that calculate normalized scores on a 100-point scale. | | `VAPI_DELETE_CALL` | Delete Call | Tool to delete a call by its unique identifier. Use when you need to remove call data from the system. Returns the deleted call object with all its associated data. | | `VAPI_DELETE_EVAL` | Delete Eval | Tool to delete an eval by ID. Use when you need to permanently remove an eval from the system. | | `VAPI_DELETE_PHONE_NUMBER` | Delete Phone Number | Tool to delete a phone number from Vapi. Use when you need to remove a phone number from your Vapi organization. Returns the deleted phone number object. | | `VAPI_GET_EVAL` | Get Eval | Tool to retrieve an eval by its ID. Use when you need to fetch details about a specific eval including its mock conversation messages and metadata. | | `VAPI_DELETE_EVAL_RUN` | Delete Eval Run | Tool to delete an eval run by its ID from Vapi. Use when you need to permanently remove an evaluation run. | | `VAPI_UPDATE_EVAL` | Update Eval | Tool to update an existing eval in Vapi. Use when you need to modify eval properties like name, description, type, or mock conversation messages. | | `VAPI_GET_ASSISTANT` | Get Assistant | Tool to retrieve a specific assistant by ID from Vapi. Use when you need to fetch details about an existing assistant. | | `VAPI_GET_CALL` | Get Call | Tool to fetch call details by ID. Use when you have a call ID and need full call information including status, duration, costs, messages, and recordings. | | `VAPI_GET_FILE` | Get File | Tool to retrieve a file by its ID from Vapi. Use when you need to get details about a specific file including its status, metadata, storage location, and timestamps. | | `VAPI_GET_INSIGHTS` | Get Insights | Tool to retrieve insights from Vapi. Use when you need to fetch insight data with optional filtering by ID, timestamps, or pagination. Returns a paginated list of insights with metadata. | | `VAPI_LIST_MONITORING_POLICIES` | List Monitoring Policies | Tool to retrieve monitoring policies from Vapi. Use when you need to list, filter, or search for monitoring policies configured in the organization. Supports filtering by policy ID, severity level, monitor ID, and date ranges for creation/update timestamps. | | `VAPI_GET_OBSERVABILITY_SCORECARD` | Get Observability Scorecard | Tool to list observability scorecards with optional filtering and pagination. Use when you need to retrieve scorecards for monitoring or analysis. | | `VAPI_LIST_PROVIDER_RESOURCES` | List Provider Resources | Tool to list provider resources from Vapi. Use when you need to retrieve pronunciation dictionaries or other resources from providers like 11labs or Cartesia. | | `VAPI_LIST_STRUCTURED_OUTPUTS` | List Structured Outputs | Tool to list structured outputs with optional filtering. Use when you need to retrieve structured output configurations with pagination support. Supports filtering by ID, name, timestamps, and includes pagination controls. | | `VAPI_GET_INSIGHTS` | Get Insights | Tool to retrieve insights from VAPI. Use when you need to list insights with optional filtering by ID, creation date, or update date. Supports pagination and sorting. | | `VAPI_LIST_ASSISTANTS` | List Assistants | Tool to list all assistants in your VAPI organization. Use when you need to retrieve information about configured assistants. Supports filtering by creation and update timestamps. | | `VAPI_LIST_CHATS` | List Chats | Tool to retrieve a list of chat conversations from VAPI. Use when you need to view existing chats, optionally filtered by assistant, squad, session, or time range. Supports pagination and sorting for efficient retrieval of large chat histories. | | `VAPI_LIST_EVALS` | List Evals | Tool to retrieve a paginated list of evals from Vapi. Use when you need to list or search evals with optional filtering by creation/update timestamps. | | `VAPI_LIST_PROVIDER_RESOURCES` | List Provider Resources | Tool to retrieve provider resources from Vapi (e.g., 11labs pronunciation dictionaries). Use when you need to list or search provider-specific resources with optional filtering by timestamps. | | `VAPI_UPDATE_INSIGHT` | Update Insight | Tool to update an existing insight configuration in VAPI. Use when you need to modify insight properties like name, queries, time range, or visualization settings. Supports all four insight types (bar, pie, line, text) with type-specific configurations. | | `VAPI_CREATE_PHONE_NUMBER` | Create Phone Number | Tool to create a phone number with VAPI. Use when you need to provision a new phone number for voice AI applications. Supports multiple providers (VAPI, Twilio, Vonage, Telnyx, BYO). Required parameters vary by provider. | | `VAPI_LIST_SCORECARDS` | List Scorecards | Tool to retrieve a paginated list of scorecards from Vapi. Use when you need to list or search scorecards with optional filtering by creation/update timestamps. | | `VAPI_CREATE_SESSION` | Create Session | Tool to create a new session in Vapi. Use when you need to establish a persistent conversation context that can span multiple chats. Sessions automatically expire after 24 hours. | | `VAPI_LIST_SESSIONS` | List Sessions | Tool to retrieve a paginated list of sessions from VAPI. Use when you need to list sessions with optional filtering by session ID, name, assistant, squad, or workflow. Supports pagination, sorting, and timestamp-based filtering. | | `VAPI_LIST_STRUCTURED_OUTPUTS` | List Structured Outputs | Tool to list structured outputs with optional filtering and pagination. Use when you need to retrieve structured output configurations from Vapi. | | `VAPI_GET_TOOL` | Get Tool | Tool to fetch tool details by ID. Use when you have a tool ID and need full tool configuration including type, messages, function definitions, and server settings. | | `VAPI_TEST_CODE_TOOL_EXECUTION` | Test Code Tool Execution | Tool to test TypeScript code execution in Vapi's code tool environment. Use when validating code before deploying it as a tool. | | `VAPI_UPDATE_TOOL` | Update Tool | Tool to update an existing Vapi tool configuration. Use when you need to modify tool properties such as function definitions, server settings, messages, or other tool-specific parameters. | | `VAPI_UPDATE_PHONE_NUMBER` | Update Phone Number | Tool to update an existing phone number configuration in VAPI. Use when you need to modify phone number settings such as name, associated assistant/workflow, or provider-specific configurations. | | `VAPI_UPLOAD_FILE` | Upload File | Tool to upload a file to Vapi Knowledge Base. Use when you need to add files for AI assistants to reference. Returns file metadata including ID, storage URLs, and processing status. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Vapi MCP server provides comprehensive access to Vapi operations through Composio. Once connected, Hermes can perform all major Vapi actions on your behalf using natural language commands. ## Complete Code None listed. ## Conclusion ### Way Forward With Vapi 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 Vapi MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/vapi/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/vapi/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/vapi/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/vapi/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/vapi/framework/codex) - [OpenClaw](https://composio.dev/toolkits/vapi/framework/openclaw) - [CLI](https://composio.dev/toolkits/vapi/framework/cli) - [Google ADK](https://composio.dev/toolkits/vapi/framework/google-adk) - [LangChain](https://composio.dev/toolkits/vapi/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/vapi/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/vapi/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/vapi/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/vapi/framework/crew-ai) ## Related Toolkits - [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed. - [Composio search](https://composio.dev/toolkits/composio_search) - Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service. - [Perplexityai](https://composio.dev/toolkits/perplexityai) - Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows. - [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow. - [Ai ml api](https://composio.dev/toolkits/ai_ml_api) - Ai ml api is a suite of AI/ML models for natural language and image tasks. It provides fast, scalable access to advanced AI capabilities for your apps and workflows. - [Aivoov](https://composio.dev/toolkits/aivoov) - Aivoov is an AI-powered text-to-speech platform offering 1,000+ voices in over 150 languages. Instantly turn written content into natural, human-like audio for any application. - [All images ai](https://composio.dev/toolkits/all_images_ai) - All-Images.ai is an AI-powered image generation and management platform. It helps you create, search, and organize images effortlessly with advanced AI capabilities. - [Anthropic administrator](https://composio.dev/toolkits/anthropic_administrator) - Anthropic administrator is an API for managing Anthropic organizational resources like members, workspaces, and API keys. It helps you automate admin tasks and streamline resource management across your Anthropic organization. - [Api labz](https://composio.dev/toolkits/api_labz) - Api labz is a platform offering a suite of AI-driven APIs and workflow tools. It helps developers automate tasks and build smarter, more efficient applications. - [Apipie ai](https://composio.dev/toolkits/apipie_ai) - Apipie ai is an AI model aggregator offering a single API for accessing top AI models from multiple providers. It helps developers build cost-efficient, latency-optimized AI solutions without juggling multiple integrations. - [Astica ai](https://composio.dev/toolkits/astica_ai) - Astica ai provides APIs for computer vision, NLP, and voice synthesis. Integrate advanced AI features into your app with a single API key. - [Bigml](https://composio.dev/toolkits/bigml) - BigML is a machine learning platform that lets you build, train, and deploy predictive models from your data. Its intuitive interface and robust API make machine learning accessible and efficient. - [Botbaba](https://composio.dev/toolkits/botbaba) - Botbaba is a platform for building, managing, and deploying conversational AI chatbots across messaging channels. It streamlines chatbot automation, making it easier to integrate AI into customer interactions. - [Botpress](https://composio.dev/toolkits/botpress) - Botpress is an open-source platform for building, deploying, and managing chatbots. It helps teams automate conversations and deliver rich, interactive messaging experiences. - [Chatbotkit](https://composio.dev/toolkits/chatbotkit) - Chatbotkit is a platform for building and managing AI-powered chatbots using robust APIs and SDKs. It lets you easily add conversational AI to your apps for better user engagement. - [Cody](https://composio.dev/toolkits/cody) - Cody is an AI assistant built for businesses, trained on your company's knowledge and data. It delivers instant answers and insights, tailored for your team. - [Context7 MCP](https://composio.dev/toolkits/context7_mcp) - Context7 MCP delivers live, version-specific code docs and examples right from the source. It helps developers and AI agents instantly retrieve authoritative programming info—no more out-of-date docs. - [Customgpt](https://composio.dev/toolkits/customgpt) - CustomGPT.ai lets you build and deploy chatbots tailored to your own data and business needs. Get precise and context-aware AI conversations without writing code. - [Datarobot](https://composio.dev/toolkits/datarobot) - Datarobot is a machine learning platform that automates model development, deployment, and monitoring. It empowers organizations to quickly gain predictive insights from large datasets. - [Deepgram](https://composio.dev/toolkits/deepgram) - Deepgram is an AI-powered speech recognition platform for accurate audio transcription and understanding. It enables fast, scalable speech-to-text with advanced audio intelligence features. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Vapi MCP? With a standalone Vapi MCP server, the agents and LLMs can only access a fixed set of Vapi tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Vapi 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 Vapi tools. ### Can I manage the permissions and scopes for Vapi while using Tool Router? Yes, absolutely. You can configure which Vapi 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 Vapi data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)