Vapi MCP Server

🚀 Vapi MCP Server

The Vapi Model Context Protocol server allows you to integrate with the Vapi API through function calls.

🚀 Quick Start

Setup for Claude Desktop

1. Open Claude Desktop and press CMD + , to enter Settings.
2. Click the Developers tab.
3. Click the Edit Configuration button.
4. This will open the claude_desktop_config.json file in the file explorer.
5. Obtain your Vapi API key at the Vapi console (https://dashboard.vapi.ai/org/api-keys).
6. Add the following content to the claude_desktop_config.json file. For more details, see here.
7. Restart Claude Desktop after editing the configuration 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 at the Vapi console (https://dashboard.vapi.ai/phone-numbers).
2. Create a new assistant using the existing 'Appointment Scheduler' template at the Vapi console (https://dashboard.vapi.ai/assistants).
3. Ensure that Claude Desktop is configured to use the Vapi MCP server and restart the Claude Desktop application.
4. Ask Claude to initiate or schedule a call. Here are some examples:

Example 1: Request an immediate call

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

Example 2: Schedule a future call

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

💻 Remote SSE Connection

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

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

This connection allows you to access Vapi's features 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

This project has two types of tests:

Unit Tests

Unit tests use mocks to test the MCP server without actually calling Vapi's API.

# Run unit tests
npm run test:unit

End-to-End Tests

• Note: The create_call operation supports immediate execution or scheduling a future call.

📞 Phone Number Tools

• list_phone_numbers: List all Vapi phone numbers.
• get_phone_number: Get detailed information about a specific phone number.