Vapi MCP for Cursor

by matthewdcage

3 stars

267 downloads

Not rated

GitHub

Developer Tools

About

Vapi MCP for Cursor is a Model Context Protocol (MCP) server that integrates Vapi's voice AI capabilities with the Cursor editor, allowing users to manage Vapi voice assistants, make outbound calls, and retrieve conversation details directly from Cursor.

Details

Author: matthewdcage
GitHub stars: 3
Downloads: 267
Categories: Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Vapi MCP for Cursor

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

From the repository

Configure the server in Cursor's .cursor/mcp.json file with the required environment variables and working directory. Build the server with npm install && npm run build inside the vapi-mcp-server directory, then set the command to node, type to stdio, and provide the absolute path to dist/index.js along with the cwd parameter.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "vapi mcp for cursor": {
            "vapi-mcp": {
                "command": "node",
                "args": [
                    "--trace-warnings",
                    "dist/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "vapi-mcp": {
        "command": "node",
        "args": [
            "--trace-warnings",
            "dist/index.js"
        ]
    }
}

# Vapi MCP for Cursor This project implements a Model Context Protocol (MCP) server for integrating Vapi's voice AI capabilities with Cursor. ## Setup Instructions ### 1. Project Structure The Vapi MCP server is structured as follows: - `vapi-mcp-server/` - Main server code - `src/` - TypeScript source files - `dist/` - Compiled JavaScript output - `.env` - Environment variables for API keys ### 2. Environment Configuration Create a `.env` file in the `vapi-mcp-server` directory with the following variables: ``` # Vapi API Keys VAPI_ORG_ID=your-org-id VAPI_PRIVATE_KEY=your-private-key VAPI_KNOWLEDGE_ID=your-knowledge-id VAPI_JWT_PRIVATE=your-jwt-private # Environment NODE_ENV=development ``` ### 3. Building the Server To build the server: ```bash cd vapi-mcp/vapi-mcp-server npm install npm run build ``` ### 4. Configuration in Cursor #### Important: Avoiding "Client Closed" Errors When configuring the Vapi MCP server in Cursor's MCP settings, pay attention to the following crucial details: 1. **Working Directory**: The `cwd` parameter is required to ensure the server runs in the correct directory and can access the `.env` file properly. 2. **Environment Variables**: Must be explicitly provided in the configuration, even if they exist in the `.env` file. 3. **Module Type**: The server uses ES modules, so the `package.json` must include `"type": "module"`. Here's the correct configuration for `.cursor/mcp.json`: ```json "Vapi Voice AI Tools": { "command": "node", "type": "stdio", "args": [ "/Users/matthewcage/Documents/AA-GitHub/MCP/vapi-mcp/vapi-mcp-server/dist/index.js" ], "cwd": "/Users/matthewcage/Documents/AA-GitHub/MCP/vapi-mcp/vapi-mcp-server", "env": { "VAPI_ORG_ID": "your-org-id", "VAPI_PRIVATE_KEY": "your-private-key", "VAPI_KNOWLEDGE_ID": "your-knowledge-id", "VAPI_JWT_PRIVATE": "your-jwt-private", "NODE_ENV": "development" } } ``` ## Troubleshooting ### "Client Closed" Error in Cursor If you see "Client Closed" in the Cursor MCP Tools panel: 1. **Check Working Directory**: Ensure the `cwd` parameter is set correctly in your mcp.json 2. **Verify Environment Variables**: Make sure all required environment variables are passed in the configuration 3. **Check Module Type**: Ensure `package.json` has `"type": "module"` 4. **Inspect Permissions**: Make sure the dist/index.js file is executable (`chmod +x dist/index.js`) 5. **Test Server Directly**: Run the server manually to check for errors: ```bash cd vapi-mcp/vapi-mcp-server node --trace-warnings dist/index.js ``` ### Module Not Found Errors If you get "Error: Cannot find module" when running: 1. **Check Working Directory**: Are you running from the correct directory? 2. **Rebuild**: Try rebuilding the project with `npm run build` 3. **Dependencies**: Ensure all dependencies are installed with `npm install` ## Available Tools The Vapi MCP server provides the following tools: 1. **vapi_call** - Make outbound calls using Vapi's voice AI 2. **vapi_assistant** - Manage voice assistants (create, get, list, update, delete) 3. **vapi_conversation** - Retrieve conversation details from calls ## Lessons Learned 1. When integrating with Cursor's MCP: - Always specify the `cwd` parameter to ensure the server runs in the correct directory - Pass all required environment variables directly in the MCP configuration - For ES modules, ensure package.json has `"type": "module"` and tsconfig.json uses appropriate module settings - Test the server directly before configuring in Cursor 2. The server command path must be absolute and correctly formed in the Cursor MCP config 3. Using stdio transport type is required for proper integration with Cursor

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Vapi MCP for Cursor

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Sequential Thinking