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
- 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"] } } }
- Authenticate
When you first use a Connect tool, Claude Code will prompt for OAuth authentication. Sign in with your voicemode.dev account.
- Connect a Client
Open the iOS app or web dashboard (voicemode.dev/dashboard) and sign in with the same account.
- 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.