Vapi MCP Server

Official
by VapiAI

Integrations

  • Allows the MCP server to be installed and run via NPX, making it easy to integrate Vapi's capabilities through the NPM package ecosystem.

Vapi MCP Server

The Vapi Model Context Protocol server allows you to integrate with Vapi APIs through function calling.

Claude Desktop Setup

  1. Open Claude Desktop and press CMD + , to go to Settings.
  2. Click on the Developer tab.
  3. Click on the Edit Config button.
  4. This will open the claude_desktop_config.json file in your file explorer.
  5. Get your Vapi API key from the Vapi dashboard (https://dashboard.vapi.ai/org/api-keys).
  6. Add the following to your claude_desktop_config.json file. See here for more details.
  7. Restart the Claude Desktop after editing the config file.
{ "mcpServers": { "vapi-mcp-server": { "command": "npx", "args": [ "-y", "@vapi-ai/mcp-server" ], "env": { "VAPI_TOKEN": "<your_vapi_token>" } } } }

Example Usage with Claude Desktop

  1. Create or import a phone number using the Vapi dashboard (https://dashboard.vapi.ai/phone-numbers).
  2. Create a new assistant using the existing 'Appointment Scheduler' template in the Vapi dashboard (https://dashboard.vapi.ai/assistants).
  3. Make sure to configure Claude Desktop to use the Vapi MCP server and restart the Claude Desktop app.
  4. Ask Claude to initiate or schedule a call. See examples below:

Example 1: Request an immediate call

I'd like to speak with my ShopHelper assistant to talk about my recent order. Can you have it call me at +1234567890?

Example 2: Schedule a future call

I need to schedule a call with Mary assistant for next Tuesday at 3:00 PM. My phone number is +1555123456.

Remote SSE Connection

To connect to Vapi's MCP server via Server-Sent Events (SSE) Transport:

  • Connect to https://mcp.vapi.ai/sse from any MCP client using SSE Transport
  • Include your Vapi API key as a bearer token in the request headers
  • Example header: Authorization: Bearer your_vapi_api_key_here

This connection allows you to access Vapi's functionality remotely without running a local server.

Development

# Install dependencies npm install # Build the server npm run build

Update your claude_desktop_config.json to use the local server.

{ "mcpServers": { "vapi-local": { "command": "node", "args": [ "<path_to_vapi_mcp_server>/dist/index.js" ], "env": { "VAPI_TOKEN": "<your_vapi_token>" } }, } }

Testing

The project has two types of tests:

Unit Tests

Unit tests use mocks to test the MCP server without making actual API calls to Vapi.

# Run unit tests npm run test:unit
End-to-End Tests

E2E tests run the full MCP server with actual API calls to Vapi.

# Set your Vapi API token export VAPI_TOKEN=your_token_here # Run E2E tests npm run test:e2e

Note: E2E tests require a valid Vapi API token to be set in the environment.

Running All Tests

To run all tests at once:

npm test

References

Supported Actions

The Vapi MCP Server provides the following tools for integration:

Assistant Tools

  • list_assistants: Lists all Vapi assistants
  • create_assistant: Creates a new Vapi assistant
  • update_assistant: Updates an existing Vapi assistant
  • get_assistant: Gets a Vapi assistant by ID

Call Tools

  • list_calls: Lists all Vapi calls
  • create_call: Creates an outbound call
  • get_call: Gets details of a specific call

Note: The create_call action supports scheduling calls for immediate execution or for a future time.

Phone Number Tools

  • list_phone_numbers: Lists all Vapi phone numbers
  • get_phone_number: Gets details of a specific phone number

Vapi Tools

  • list_tools: Lists all Vapi tools
  • get_tool: Gets details of a specific tool

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables integration with Vapi APIs through function calling via the Model Context Protocol, allowing AI models to access Vapi's capabilities.

  1. Claude Desktop Setup
    1. Example Usage with Claude Desktop
  2. Remote SSE Connection
    1. Development
      1. Testing
    2. References
      1. Supported Actions
        1. Assistant Tools
        2. Call Tools
        3. Phone Number Tools
        4. Vapi Tools

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        Enables users to access and manage Replicate's AI models and predictions via the Model Context Protocol, offering tools for creating, canceling, and retrieving model predictions and parameters.
        Last updated -
        12
        224
        32
        TypeScript
        MIT License
      • -
        security
        A
        license
        -
        quality
        Enables AI agents and assistants like Goose or Claude to interact with VS Code through the Model Context Protocol.
        Last updated -
        14
        TypeScript
        Apache 2.0
        • Apple
      • -
        security
        -
        license
        -
        quality
        An open standard server implementation that enables AI assistants to directly access APIs and services through Model Context Protocol, built using Cloudflare Workers for scalability.
        Last updated -
        TypeScript
      • A
        security
        A
        license
        A
        quality
        A Model Context Protocol server enabling AI assistants to interact with Kong Konnect's API Gateway, providing tools to query analytics data, inspect configurations, and manage control planes through natural language.
        Last updated -
        10
        22
        TypeScript
        Apache 2.0
        • Apple

      View all related MCP servers

      ID: 36gq6pif6r