The server is open source under Apache-2.0 and free to run, but it calls Vonage's APIs, which are paid: SMS, WhatsApp, RCS, voice, and number rentals bill per message or per number against your Vonage account credits.

Does it support remote/OAuth?

No. The canonical mode is local stdio via npx @vonage/vonage-mcp-server-api-bindings, authenticated with your Vonage application ID, private key, and API key/secret as environment variables rather than an OAuth flow.

Which channels can it send on?

SMS, WhatsApp (with optional SMS failover), RCS (with optional SMS failover), and outbound voice messages. Optional environment variables set default sender numbers per channel so the agent doesn't repeat them on every call.

Vonage MCP server

OfficialVonageConfig last verified Jun 1, 2026

Vonage's official MCP server: send SMS, WhatsApp, RCS, and voice messages, manage numbers and applications, and pull account reports from your agent.

Vonage MCP is Vonage's official server that exposes its programmable communications APIs as agent tools. Vonage (the API platform formerly known as Nexmo) sends SMS, WhatsApp, RCS, and voice across the globe, and this server lets an agent reach those channels directly — text a status update, send a WhatsApp message with automatic SMS failover, place an outbound voice message, or fan a notification out over RCS. Beyond messaging it covers the account-management surface a real integration needs: checking your balance, searching for and provisioning phone numbers, creating and listing Vonage applications, linking numbers to applications, pulling activity reports, and even charting the data it retrieves.

It runs locally over stdio with npx using the @vonage/vonage-mcp-server-api-bindings package. Authentication uses your Vonage credentials supplied as environment variables — an application ID with a base64-encoded private key for the Messages and Voice APIs, plus the account API key and secret — and optional variables set default sender numbers for virtual numbers, WhatsApp, and RCS so the agent doesn't have to specify them on every call. The package is licensed under Apache-2.0.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json

json

{
  "mcpServers": {
    "vonage": {
      "command": "npx",
      "args": [
        "-y",
        "@vonage/vonage-mcp-server-api-bindings"
      ],
      "env": {
        "VONAGE_APPLICATION_ID": "<VONAGE_APPLICATION_ID>",
        "VONAGE_PRIVATE_KEY64": "<VONAGE_PRIVATE_KEY64>",
        "VONAGE_API_KEY": "<VONAGE_API_KEY>",
        "VONAGE_API_SECRET": "<VONAGE_API_SECRET>",
        "VONAGE_VIRTUAL_NUMBER": "<VONAGE_VIRTUAL_NUMBER>",
        "VONAGE_WHATSAPP_NUMBER": "<VONAGE_WHATSAPP_NUMBER>",
        "RCS_SENDER_ID": "<RCS_SENDER_ID>"
      }
    }
  }
}

Or via CLI

bash

claude mcp add vonage -- npx -y @vonage/vonage-mcp-server-api-bindings

Step-by-step guides

Available tools

Tool	Description
balance	Get your Vonage account balance.
list-applications	List all applications attached to your API key.
create-application	Create a new Vonage application with a specified name.
list-purchased-numbers	List the telephone numbers associated with your account.
search-available-numbers	Search for available phone numbers to buy in a specific country.
link-number-to-vonage-application	Link an owned number to a Vonage application.
get-records-report	Retrieve activity records from the Vonage Reports API.
SMS	Send SMS messages using Vonage.
whatsapp-send-text	Send text messages via WhatsApp.
whatsapp-send-text-with-sms-failover	Send a WhatsApp message with automatic SMS failover.
rcs-send-text	Send text messages via RCS.
rcs-send-text-with-sms-failover	Send an RCS text message with automatic SMS failover.
outbound-voice-message	Send outbound voice messages with Vonage.
make-chart	Create a chart based on data retrieved from the account.

Required configuration

VONAGE_APPLICATION_IDRequired
Vonage application ID used with the Messages and Voice APIs. Required.
VONAGE_PRIVATE_KEY64Required
Base64-encoded private key for your Vonage application. Required.
VONAGE_API_KEYRequired
Vonage account API key. Required.
VONAGE_API_SECRETRequired
Vonage account API secret. Required.
VONAGE_VIRTUAL_NUMBEROptional
Default sender virtual number for SMS and voice. Optional.
VONAGE_WHATSAPP_NUMBEROptional
Default WhatsApp sender number. Optional.
RCS_SENDER_IDOptional
Default RCS sender ID. Optional.

What you can do with it

Message customers across channels

Have the agent send an SMS, WhatsApp, or RCS message — or send WhatsApp with automatic SMS failover so the notification still lands if the rich channel is unavailable — without hand-wiring the Messages API.

Provision and manage numbers and apps

Ask the agent to check your balance, search for an available number in a country, buy and link it to a Vonage application, then pull a records report and chart the activity, all from one server.

FAQ

Is it free?: The server is open source under Apache-2.0 and free to run, but it calls Vonage's APIs, which are paid: SMS, WhatsApp, RCS, voice, and number rentals bill per message or per number against your Vonage account credits.
Does it support remote/OAuth?: No. The canonical mode is local stdio via npx @vonage/vonage-mcp-server-api-bindings, authenticated with your Vonage application ID, private key, and API key/secret as environment variables rather than an OAuth flow.
Which channels can it send on?: SMS, WhatsApp (with optional SMS failover), RCS (with optional SMS failover), and outbound voice messages. Optional environment variables set default sender numbers per channel so the agent doesn't repeat them on every call.

← Browse all communication servers