https://a.storyblok.com/f/270183/1368x665/45c83022d1/26jun_dev-blog_outbound-voice-call-claude.jpg

Make an Outbound Voice Call by Asking Claude

Published on June 11, 2026

Time to read: 5 minutes

Introduction

I’ve shown you how the Vonage Tooling MCP Server can be accessed via Postman. In today’s blog post, I’ll show you how to access it via Claude Desktop, and the use case I’ll focus on is to trigger a real outbound voice call using the same way you might communicate with LLMs, some natural language prompt. We’ll use Claude Desktop, create a Vonage account, get some API keys, add them to Claude, and see everything in action.

Prerequisites

Before we get started and place that phone call, you'll need:

  • To create an application, go to the Create an Application page on the Vonage Dashboard, and define a Name for your Application.

  • If you intend to use an API that uses Webhooks, you will need a private key. Click “Generate public and private key”, your download should start automatically. Store it securely; this key cannot be re-downloaded if lost. It will follow the naming convention private_<your app id>.key. This key can now be used to authenticate API calls. Note: Your key will not work until your application is saved.

  • Choose the capabilities you need (e.g., Voice, Messages, RTC, etc.) and provide the required webhooks (e.g., event URLs, answer URLs, or inbound message URLs). These will be described in the tutorial.

  • To save and deploy, click "Generate new application" to finalize the setup. Your application is now ready to use with Vonage APIs.

Select the “Voice” under Capabilities, as we are going to use the voice API to make calls.

Click to save your newly created Vonage application with the voice capability at the bottom right.

Add the Vonage Tooling MCP Server to Claude Desktop

Open Claude Desktop and on the settings tab, click on “developer” and click on “edit config”. This will take you to your “claude_desktop_config.json”, but you can also open it directly, as shown below:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json, which usually resolves to something along the lines of C:\Users\username\AppData\Local\Packages\Claude\LocalCache\Roaming\Claude

{

  "mcpServers": {

    "vonage-tooling": {

      "command": "npx",

      "args": [

        "-y",

        "@vonage/vonage-mcp-server-api-bindings"

      ],

      "env": {

        "VONAGE_API_KEY": "YOUR_API_KEY",

        "VONAGE_API_SECRET": "YOUR_API_SECRET",

        "VONAGE_APPLICATION_ID": "YOUR_APP_ID",

        "VONAGE_PRIVATE_KEY64": "YOUR_BASE64_PRIVATE_KEY",

        "VONAGE_VIRTUAL_NUMBER": "+1234567890"

      }

    }

  }

}

Open your API Settings Page to access your Vonage API Key and Secret, both of which are displayed as shown in the screenshot below. The API Key is located at the top of the page, and to access your API Secret, please refer to the “Account secret” subsection. 

Note: In case you cannot remember your previously created API Secret, click on “+ Create new secret” and save it securely.

To buy a virtual phone number, go to your API dashboard and follow the steps shown below.

Steps on how to purchase a phone number from the dashboard, from selecting the number and confirming the selection.Purchase a phone number

  1. Go to your API dashboard

  2. Navigate to BUILD & MANAGE > Numbers > Buy Numbers.

  3. Choose the attributes needed and then click Search

  4. Click the Buy button next to the number you want and validate your purchase

  5. To confirm you have purchased the virtual number, go to the left-hand navigation menu, under BUILD & MANAGE, click Numbers, then Your Numbers

Note: VONAGE_PRIVATE_KEY64 is your private key file base64-encoded. On macOS/Linux, you can generate it with base64 -i private.key | tr -d '\n' . I wanted to copy it to my clipboard whilst doing this on GitHub Codespaces, and I used the following command: base64 -i private.key | tr -d '\n' > b64_key.txt && code b64_key.txt to copy it to a new txt file, but you can use | pbcopy on macOS to copy it to your clipboard.

Save the file and don’t forget to restart Claude Desktop, so that everything you’ve added is applied. You should see the Vonage tools appear in the Connectors tab of the settings. Make sure to give permission to the “Outbound Voice Message” tool.

Permissions interface showing various communication tools with options to toggle access settings on or off.Tools Permissions

Make the Outbound Voice Call

Now that the setup is done, open a new conversation in Claude Desktop and type something along the lines of: "Use the Vonage outbound voice message tool to call +44XXXXXXXXX and say: Hello, this is a test call from Claude."

Claude will identify the outbound-voice-message tool from the Vonage Tooling MCP, which maps directly to the Vonage Voice API under the hood. The MCP server handles authentication and the API call; you just described what you wanted in plain English. It confirms the parameters and places the call.

Your phone rings and speaks the message using text-to-speech. You can try writing a different text that you would like to be spoken from the text.

Screenshot of a Vonage outbound voice message tool, confirming a successful test call placement with a specific call ID.Claude Conversation

Conclusion

Why not try the other Tools with Claude? Check your account balance before placing the call, list your applications and numbers to pick the right one, send an SMS follow-up after the call, all with the same natural language prompting.

It’s pretty cool what we can do with Claude Desktop and the Vonage MCP Servers. In my next blog post, I’ll show how you can interact with the Vonage MCPs using Google Antigravity. Stay tuned.

Have a question or want to share what you're building?

Stay connected and keep up with the latest developer news, tips, and events.

Share:

https://a.storyblok.com/f/270183/400x400/3f6b0c045f/amanda-cavallaro.png
Amanda CavallaroDeveloper Advocate