How to integrate Vapi MCP with Hermes

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.

Vapi logoVapi
Api Key

Vapi is a voice AI platform for building, testing, and deploying conversational voice agents. It provides real-time responses and seamless integration for voice-driven applications.

42 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 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

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.

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
Hermes authenticating with Composio

2. Authenticate

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

3. Connect to Vapi

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

4. Done. You're all set with a new Vapi 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 Vapi or request any Vapi-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

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 or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

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

Update Assistant

Tool to update an existing Vapi assistant configuration.

List Calls

Tool to list calls from Vapi.

Delete Chat

Tool to delete a chat by its ID from Vapi.

Get Chat

Tool to fetch chat details by ID.

Create Analytics Queries

Tool to create and execute analytics queries on VAPI data.

Create Assistant

Tool to create a new Vapi assistant with specified transcriber, voice, and AI model configurations.

Create Eval

Tool to create an eval for testing conversation flows.

Create OpenAI Chat

Tool to create an OpenAI-compatible chat using the Vapi API.

Create Phone Number

Tool to create a phone number with Vapi.

Create Monitoring Policy

Tool to create a monitoring policy in VAPI.

Create Provider Resource

Tool to create an 11Labs pronunciation dictionary resource.

Create Scorecard

Tool to create a scorecard for observability and evaluation.

Delete Call

Tool to delete a call by its unique identifier.

Delete Eval

Tool to delete an eval by ID.

Delete Phone Number

Tool to delete a phone number from Vapi.

Get Eval

Tool to retrieve an eval by its ID.

Delete Eval Run

Tool to delete an eval run by its ID from Vapi.

Update Eval

Tool to update an existing eval in Vapi.

Get Assistant

Tool to retrieve a specific assistant by ID from Vapi.

Get Call

Tool to fetch call details by ID.

Get File

Tool to retrieve a file by its ID from Vapi.

Get Insights

Tool to retrieve insights from Vapi.

List Monitoring Policies

Tool to retrieve monitoring policies from Vapi.

Get Observability Scorecard

Tool to list observability scorecards with optional filtering and pagination.

List Provider Resources

Tool to list provider resources from Vapi.

List Structured Outputs

Tool to list structured outputs with optional filtering.

Get Insights

Tool to retrieve insights from VAPI.

List Assistants

Tool to list all assistants in your VAPI organization.

List Chats

Tool to retrieve a list of chat conversations from VAPI.

List Evals

Tool to retrieve a paginated list of evals from Vapi.

List Provider Resources

Tool to retrieve provider resources from Vapi (e.

Update Insight

Tool to update an existing insight configuration in VAPI.

Create Phone Number

Tool to create a phone number with VAPI.

List Scorecards

Tool to retrieve a paginated list of scorecards from Vapi.

Create Session

Tool to create a new session in Vapi.

List Sessions

Tool to retrieve a paginated list of sessions from VAPI.

List Structured Outputs

Tool to list structured outputs with optional filtering and pagination.

Get Tool

Tool to fetch tool details by ID.

Test Code Tool Execution

Tool to test TypeScript code execution in Vapi's code tool environment.

Update Tool

Tool to update an existing Vapi tool configuration.

Update Phone Number

Tool to update an existing phone number configuration in VAPI.

Upload File

Tool to upload a file to Vapi Knowledge Base.

FAQ

Frequently asked questions

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.

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.

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.

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.

Start with Vapi.It takes 30 seconds.

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

Start building