# Vapi

```json
{
  "name": "Vapi",
  "slug": "vapi",
  "url": "https://composio.dev/toolkits/vapi",
  "markdown_url": "https://composio.dev/toolkits/vapi.md",
  "logo_url": "https://logos.composio.dev/api/vapi",
  "categories": [
    "ai & machine learning"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-03-29T06:54:31.728Z"
}
```

![Vapi logo](https://logos.composio.dev/api/vapi)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Vapi MCP or direct API to create voice agents, manage conversations, deploy workflows, and analyze call interactions through natural language.

## Summary

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.

## Categories

- ai & machine learning

## Toolkit Details

- Tools: 42

## Images

- Logo: https://logos.composio.dev/api/vapi

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Vapi.
  - Setup:
    - Configure Api Key credentials for Vapi.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Start a new outbound call campaign
- Get transcript from the last agent call
- Pause all ongoing voice agent sessions

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

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Vapi Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Vapi actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Start a new voice agent session with the welcome script.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Start a new voice agent session with the welcome script.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Vapi
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Vapi tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Start a new voice agent session with the welcome script.')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Start a new voice agent session with the welcome script.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Vapi Integration

- Supports both Vapi MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Vapi data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Vapi access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Vapi
- Scoped, least privilege access to Vapi resources
- Full audit trail of agent actions to support review and compliance

## Use Vapi with any AI Agent Framework

Choose a framework you want to connect 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)
- [Hermes](https://composio.dev/toolkits/vapi/framework/hermes-agent)
- [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)
- [Pydantic AI](https://composio.dev/toolkits/vapi/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/vapi/framework/autogen)

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

### Do I need my own developer credentials to use Vapi with Composio?

Yes, Vapi requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)