mcp-vapi

MCP server for Vapi, lets Claude Code, Cursor, Windsurf, and any MCP-compatible AI client manage your voice assistants, fire outbound calls, and inspect call history directly from your AI coding environment.

No more copy-pasting assistant IDs from the dashboard. Just ask Claude.

What You Can Do

Once connected, your AI client can:

• List, create, update, delete assistants: iterate on prompts without touching the dashboard
• Fire outbound calls: trigger calls to any number with any assistant
• Pull call transcripts: get the full transcript + recording URL of any call
• Manage phone numbers: list your Vapi numbers and grab their IDs
• Work with squads: create and manage multi-assistant handoff flows

Available Tools

| Tool | Description | |---|---| | vapi_list_assistants | List all assistants in your account | | vapi_get_assistant | Get full config of a specific assistant | | vapi_create_assistant | Create a new voice assistant | | vapi_update_assistant | Update an assistant (partial update) | | vapi_delete_assistant | Delete an assistant | | vapi_create_call | Fire an outbound call | | vapi_list_calls | List calls with filters | | vapi_get_call | Get call details, transcript, recording | | vapi_end_call | Force-end an active call | | vapi_list_phone_numbers | List your Vapi phone numbers | | vapi_get_phone_number | Get a specific phone number | | vapi_list_squads | List all squads | | vapi_get_squad | Get squad details | | vapi_create_squad | Create a multi-assistant squad | | vapi_update_squad | Update a squad | | vapi_delete_squad | Delete a squad |

Setup

1. Get Your Vapi API Key

1. Go to dashboard.vapi.ai
2. Click your account avatar → API Keys
3. Copy your Private Key

Use the private key, not the public key. The public key is for client-side SDKs.

2. Add to Claude Code

claude mcp add vapi -e VAPI_API_KEY=your_key_here -- npx -y mcp-vapi

That's it. Restart Claude Code and the Vapi tools will be available.

3. Add to Claude Desktop

Open your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this to the mcpServers section:

{
  "mcpServers": {
    "vapi": {
      "command": "npx",
      "args": ["-y", "mcp-vapi"],
      "env": {
        "VAPI_API_KEY": "your_key_here"
      }
    }
  }
}

Restart Claude Desktop.

4. Add to Cursor / Windsurf

In your MCP settings file, add:

{
  "mcpServers": {
    "vapi": {
      "command": "npx",
      "args": ["-y", "mcp-vapi"],
      "env": {
        "VAPI_API_KEY": "your_key_here"
      }
    }
  }
}

Usage Examples

Once connected, just talk to your AI:

"List all my Vapi assistants"

Claude calls vapi_list_assistants and returns the names + IDs

"Create a new assistant called 'HVAC Receptionist' with this system prompt: [paste prompt]"

Claude calls vapi_create_assistant with the right params

"Fire a test call to +14155550100 using assistant ID abc123 from phone number xyz789"

Claude calls vapi_create_call with your phone number ID, the customer number, and assistant ID

"Get the transcript from call ID def456"

Claude calls vapi_get_call and returns the full transcript + recording URL

"Update the system prompt on assistant abc123 to [new prompt]"

Claude calls vapi_update_assistant with just the systemPrompt field

Tips

You still need a Vapi phone number to make outbound calls. Buy one at dashboard.vapi.ai → Phone Numbers, then list them with vapi_list_phone_numbers to grab the ID.

E.164 format for phone numbers. Always +[country code][number], no dashes or spaces. +14155550100 ✅, 415-555-0100 ❌.

Metadata is your friend. Pass a metadata object when creating a call, it comes back on every webhook event so you can link calls to CRM records, campaigns, or anything else.

assistantOverrides is super useful. You don't need a separate assistant per lead. Create one assistant and pass per-call overrides like firstMessage, variableValues, or serverUrl when you create the call.

Pagination is timestamp-based. Vapi doesn't use page numbers, use createdAtGt/createdAtLt to paginate through large result sets.

Local Development

git clone https://github.com/adhirajhangal/mcp-vapi
cd mcp-vapi
npm install
npm run build

# test it
VAPI_API_KEY=your_key node dist/index.js

To use your local build in Claude Code:

claude mcp add vapi-local -e VAPI_API_KEY=your_key -- node /path/to/mcp-vapi/dist/index.js

Resources

• Vapi API Docs
• Vapi Dashboard
• Model Context Protocol
• Claude Code MCP Docs

License

MIT