- check your balance, billing transactions, live calls and call history
- place calls that speak a message or play audio (“call me and play this”), control calls and conferences, stream call audio to your AI agent, and build VobizXML IVRs
- manage phone numbers, SIP trunks, credentials, IP allow-lists, SIP endpoints, voice applications and sub-accounts
- send and track SMS, MMS and RCS messages
- schedule reminder and wake-up calls to your phone, with your own audio if you like (“call me at…”)
This server acts on your account. To search the documentation instead, use the Vobiz Docs MCP server. The two work well side by side.
Prerequisites
- A Vobiz account and its Auth ID and Auth Token, from the overview page of the Vobiz console.
- Node.js 22.9 or newer for the local options (
node --version).
Connect Claude step by step
The hosted connector works in claude.ai, Claude Desktop and the Claude mobile apps. There is nothing to install: you add a URL and sign in with your Vobiz credentials.1
Copy your Vobiz credentials
Sign in to the Vobiz console. On the overview page, copy your Auth ID (it starts with
MA_, or SA_ for a sub-account) and your Auth Token.2
Open Connectors in Claude
In claude.ai or Claude Desktop, open Settings → Connectors and click Add custom connector.On a Team or Enterprise plan, an Owner adds custom connectors for the organization under Admin settings → Connectors. Members then connect their own Vobiz account in Settings → Connectors.
3
Add the Vobiz MCP server
Enter a name, for example Leave the advanced OAuth fields empty, then click Add.
Vobiz, and the URL:4
Connect and sign in
Click Connect. A Vobiz sign-in page opens and shows which app is asking for access.
- Paste your Auth ID and Auth Token.
- Under Access, choose Full access, Personal assistant or Read-only (see Choose what Claude can do).
- For full access or personal assistant, fill in Call me on, and optionally Call from and Timezone.
- Click Allow access.
5
Turn on the tools in a chat
Start a new chat, open the tools menu in the message box and make sure Vobiz is enabled. Then try:Claude asks before it runs any tool that places a call, sends a message or changes your account, and the server also needs your confirmation for each one.
Know which app is asking
The Vobiz sign-in page tells you which app wants to use your account before you enter anything:
You can still choose any access level for any app. Pick Full access only for an app you trust.
Choose what Claude can do
The Vobiz sign-in page asks you to pick one of three access levels:
For Full access and Personal assistant, the page also asks for three details used by reminder calls:
These details are sealed into the access token together with your credentials. With Personal assistant, Claude can only call the number you entered under Call me on, so it is a safe choice for a connector you use as a personal assistant.
Call me and play this
With Full access on the hosted connector, Claude can place a call right now and speak a message or play audio on it, in one step:make_call with the content:
The Vobiz MCP server hosts the call-control VobizXML for you, so you don’t need a server or an answer URL of your own. The call plays or speaks the content, then hangs up. A call placed with none of these inputs (and no
answer_url) only plays a short greeting and ends.
play needs a link to the audio file itself. Page links such as Pixabay, YouTube or Spotify pages can’t be played on a call. Copy the direct file link instead, or upload the file to your audio library and use its name.
say and play are available on the hosted connector (https://mcp.vobiz.ai/mcp). With the local npm server, pass your own answer_url that returns VobizXML.
Call me at…
On the hosted connector, you can ask Claude or ChatGPT for a phone call at a set time:schedule_reminder_call once. At that time, Vobiz calls you from your chosen Vobiz number and speaks the message. The call ends with “Press 1 or say snooze…”. Press a key or say the word:
Key presses count while the message is still playing.
If you don’t answer, the line is busy, or the call goes to voicemail, Vobiz tries again every
retry_minutes (5 by default), up to max_attempts calls in total (3 by default). Ask Claude for a different snooze time, number of attempts or retry interval when you set the reminder.
To manage reminders, ask Claude to list, check or cancel them. It uses list_reminder_calls, get_reminder_call (every attempt and what happened on it) and cancel_reminder_call (after you confirm).
Use your own audio
You can play your own audio, such as an alarm sound or a message you recorded, on a reminder or wake-up call, or on a call you place right away. On a reminder call, the audio plays at the start of the call, before the spoken message. Add files to your audio library in one of three ways:
Then name the audio when you set the reminder:
audio to schedule_reminder_call. It lists your files with list_audio, and deletes one with delete_audio after you confirm.
MP3, WAV, M4A, OGG, WEBM, AAC and FLAC files work. Vobiz converts each file to telephone audio and stores it privately for your account only. Your files never get a public link. If you delete a file after you schedule a reminder, the call still speaks its message.
How it works. The reminder is scheduled on the Vobiz MCP server at
mcp.vobiz.ai, not in the chat. Once Claude has scheduled it, nothing has to stay open: the call still arrives with your laptop closed or the chat ended. Reminder calls are available only on the hosted connector (https://mcp.vobiz.ai/mcp), not on the local npm server.
Change access or disconnect
If something goes wrong
Connect any client in one step
Every client below connects to the hosted server and signs you in on a Vobiz page, so no Auth Token goes in a config file.
Working in a terminal?
vobiz mcp install <client> from the Vobiz CLI writes this server into Claude Code, Cursor, Codex, VS Code, Gemini CLI, Windsurf, Zed or Claude Desktop for you.
npm package
The server is published on npm as@vobiz/mcp and listed in the official MCP Registry as io.github.vobiz-ai/vobiz-mcp. It needs Node.js 22.9 or newer.
vobiz-mcp command has three modes:
Settings come from environment variables.
VOBIZ_AUTH_ID and VOBIZ_AUTH_TOKEN are required for local use. The full list is in .env.example.
Run it locally
To run the server on your own machine instead, pick your client. The local options need Node.js 22.9 or newer.- Claude Desktop extension
- Claude Code
- Codex
- Gemini CLI
- Cursor, VS Code and others
- Download
vobiz-mcp-v1.4.2.mcpbfrom the latest release. - Open the file. Claude Desktop shows the install screen.
- Enter your Auth ID and Auth Token, then choose whether Claude may place calls, send messages or change your account.
Turn on actions
With the hosted connector, calling, messaging, account changes and reminder calls are available with Full access. Personal assistant allows only reminder calls to your own number, and Read-only allows no actions. Number purchases are not offered there. When you run the server locally (desktop extension, plugin ornpx), it reads your account and generates VobizXML out of the box. Calling, messaging and account changes stay off until you enable them:
When an action is enabled, the model still has to confirm it with you before running it:
- Confirmation. Calls, messages, purchases, transfers, provisioning and deletes need your explicit approval. Clients that support MCP elicitation show you an approval form from the server; other clients pass
confirm: trueafter you agree. Controls on a call you already placed (such as sending DTMF, playing or stopping audio, or muting a conference member) run without a second confirmation. - Idempotency keys. These prevent a retry from calling or texting twice.
- Server limits. Destination countries, call duration, calls and messages per minute and per hour, concurrency, a balance floor and a spending cap all apply, and each one can be configured.
What you can ask
Tools
To load only some groups, set
VOBIZ_TOOLSETS, for example VOBIZ_TOOLSETS=calls,records,skills. Set VOBIZ_READ_ONLY=true to keep only read-only tools. SIP passwords, credential secrets and sub-account tokens are always redacted; view or reset them in the console.
The hosted connector offers every tool except number purchases and the IVR tools that need a callback server of their own: gather_dtmf, get_gather_result, list_webhook_events, hold_call and unhold_call. Use the npm package in HTTP mode for those. The full input reference for every tool is in the repository.
Skills, prompts and resources
The server bundles the Vobiz Agent Skills and exposes each one three ways:- Tools.
list_vobiz_skillsandget_vobiz_skillwork in every client. - Prompts. Each skill is a prompt with an optional task. In Claude Code, type
/mcp__vobiz__vobiz-voice-xml build an IVR for a clinic. - Resources.
vobiz://skills/indexandvobiz://skills/{name}.
Security
The hosted connector is an OAuth 2.1 authorization server and MCP resource server in one:- Sign-in. Authorization code flow with PKCE (S256). Clients identify themselves with a Client ID Metadata Document or through Dynamic Client Registration, and tokens are bound to the connector as their resource.
- Sessions. Access tokens are short-lived. Refresh tokens rotate on every use, with reuse detection, and each refresh checks your credentials with Vobiz again. A session lasts at most 90 days.
- Revocation. The connector supports OAuth token revocation, so a client can end its session at any time. Rotating your Auth Token in the console ends every session for your account.
- Credentials. Your Auth ID and Auth Token are sealed (encrypted) inside the tokens your client holds and the encrypted grant. The server stores them nowhere else.
- Approvals. In clients that support MCP elicitation, the server asks you to approve each call, message, transfer, stream and account change in a form that shows the destination. Text from third parties, such as message bodies, is marked as untrusted so the model treats it as data, not instructions.
Privacy
The server uses your Auth ID and Auth Token only to call the Vobiz API on your behalf. The hosted connector stores only what it needs to run your requests:
The connector stores no conversation content, and logs never contain tokens, message text or phone numbers. It does not read your conversation history or files. See the Vobiz privacy policy.
Where the server is listed
The Vobiz MCP server is published in these registries and directories. Each listing points back to this page.- Official MCP Registry:
io.github.vobiz-ai/vobiz-mcp - npm:
@vobiz/mcp - Glama: Vobiz MCP Server
- GitHub: vobiz-ai/Vobiz-MCP-Server
Troubleshooting
Related
Vobiz Docs MCP server
Search the documentation from your AI client.
Agent Skills
Install the Vobiz skills into your coding agent.
Vobiz CLI
Install this server into your clients with
vobiz mcp install.Authentication
Find and rotate your Auth ID and Auth Token.