Connect Claude

Connect SimpleVox to Claude and work your calls and customers from any chat. Claude uses SimpleVox through a custom connector, with your own SimpleVox sign-in and only the permissions you give it.

Before you start

• A SimpleVox account in a workspace, with access to at least one number.
• A Claude plan that includes custom connectors. Anthropic’s help pages list which plans do; free accounts are limited to one custom connector.
• The SimpleVox server address: https://my.simplevox.app/mcp. It’s also on Settings → Integrations in SimpleVox, with a Copy button.

Add the connector

Individual plans

1. In Claude on the web or the desktop app, open Customize, then Connectors. In some versions this is under Settings.

2. Choose Add custom connector.

3. Enter a name, such as SimpleVox, and the server URL https://my.simplevox.app/mcp.

4. If Claude asks about authentication, choose Sign in now. For OAuth client, choose Register automatically. SimpleVox supports automatic registration but not Use Claude’s published identity. Leave any OAuth client ID, secret and request headers empty: SimpleVox doesn’t use API keys for AI connections.

5. Choose Add. If Claude doesn’t start sign-in straight away, choose Connect next to SimpleVox. When Claude opens SimpleVox in your browser, sign in if you’re asked to.

6. Check the consent screen: the workspace and email shown are yours, and the Redirect URI is a claude.ai address.

7. Choose what it can do. Tick any permissions you want under Also allow it to, and choose All numbers you can access or Only the numbers I choose. Then choose Authorize. See Choose what each connection can do.

8. You’re sent back to Claude, and SimpleVox shows as connected.

Team and Enterprise

On Team and Enterprise plans, an owner adds the connector once for the organization. Each person then connects it with their own SimpleVox sign-in.

1. Owner: in Claude, open Organization settings, then Connectors.

2. Owner: choose Add, then Custom. If Claude asks for the connector type, choose Web. Enter the server URL https://my.simplevox.app/mcp. If Claude asks about the OAuth client, choose Register automatically, and leave any client ID and secret empty. Then choose Add.

3. Each person: open Customize, then Connectors, find SimpleVox (it has a Custom label) and choose Connect.

4. Sign in to SimpleVox with your own account, check the workspace, email and Redirect URI, choose permissions and numbers, and choose Authorize.

Adding the connector for the organization doesn’t give anyone access to SimpleVox. Each person sees only what their own SimpleVox account and connection allow.

Once it’s connected, SimpleVox works in Claude on the web, the desktop app and the mobile apps.

Note

Menu names change between Claude versions, and the add-connector dialog can look different from one account to another. If you can’t find these options, check Anthropic’s help pages for adding a custom connector by URL. Claude doesn’t let you change a connector’s sign-in settings after you add it: remove it and add it again.

Claude Code

Add SimpleVox from your terminal:

claude mcp add --transport http simplevox https://my.simplevox.app/mcp

Then start Claude Code, run /mcp, choose simplevox and authenticate. Your browser opens SimpleVox’s sign-in and consent screen. The Redirect URI is an address on your own computer, such as http://localhost: followed by a port, and SimpleVox labels it An app on this computer. Choose permissions and numbers, then Authorize, and return to the terminal.

Use it in a chat

Turn SimpleVox on for the chat: choose + at the lower left of the message box, then Connectors, and switch SimpleVox on. Then ask a question:

Who called the Office number today? What did each person want?

If you gave the connection more permissions, you can ask Claude to act too:

Text the customer from this morning’s voicemail on the Office number and tell them we can come Thursday at nine. Show me the text before you send it.

Before approving an action, read Control and safety. Claude may also ask you to approve a tool before it runs it. Think twice before choosing Always allow for Send a text or Start a call. In Customize → Connectors you can block individual SimpleVox tools you don’t want Claude to use.

For call setup, see Assisted calls. For more ideas, see example prompts.

Disconnect

To stop Claude using SimpleVox, remove the connector in Claude under Customize → Connectors. You can also choose Disconnect next to it on Settings → Integrations in SimpleVox. That stops access straight away, even if Claude still lists the connector.

Troubleshooting

• Sign-in fails or Claude says it couldn’t connect. Check the address is exactly https://my.simplevox.app/mcp, with no slash at the end, and that the OAuth client is set to register automatically. Remove the connector and add it again. If it still fails, email support@simplevox.net and say which Claude app you’re using.
• Claude says it needs to reconnect. The connection was disconnected, your access changed, or it hasn’t been used for a long time. Connect again from Customize → Connectors.

For account setup, missing numbers, permissions, texting or calling problems, see AI tools troubleshooting.