VoiceMode Connect

Voice conversations through the voicemode.dev cloud platform. Connect your AI assistant to voice clients (iOS app, web app) without running local STT/TTS services.

How It Works

Agents (Claude Code, claude.ai) connect via MCP to voicemode.dev. Clients (iOS app, web app) connect via WebSocket. The platform routes voice messages between them.

Quick Setup

1. Add the MCP Server

Add to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "voicemode-dev": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://voicemode.dev/mcp"]
    }
  }
}

2. Authenticate

When you first use a Connect tool, Claude Code will prompt for OAuth authentication. Sign in with your voicemode.dev account.

3. Connect a Client

Open the iOS app or web dashboard (voicemode.dev/dashboard) and sign in with the same account.

4. Start Talking

Use the status tool to see connected devices, then use converse to have a voice conversation.

MCP Tools

Tool	Description
`status`	Show connected devices and agents
`converse`	Two-way voice conversation via connected client

Relationship to Local VoiceMode

Feature	Local VoiceMode	VoiceMode Connect
STT/TTS	Local (Whisper/Kokoro)	Client device (phone/browser)
Setup	Install services	Just add MCP server
Internet	Optional	Required
Latency	Lower	Higher
Mobile voice	No	Yes

Use both: Local VoiceMode for desktop voice, Connect for mobile voice.

Documentation

Overview - What is VoiceMode Connect
Architecture - How agents and clients connect
Claude Code Setup - Detailed setup guide
MCP Tools Reference - Tool parameters

Open Questions

How do multiple agents on the same account interact?
What happens when multiple clients are connected?
How is the target device selected for converse?

These are documented in docs/connect/ as we learn more.

voicemode-connect