Voicemode Connect

1---
2name: voicemode-connect
3description: Remote voice via VoiceMode Connect. Use when users want to add voice to Claude Code using their phone or web app, without local STT/TTS setup.
4---
5 
6# VoiceMode Connect
7 
8Voice conversations through the voicemode.dev cloud platform. Connect your AI assistant to voice clients (iOS app, web app) without running local STT/TTS services.
9 
10## How It Works
11 
12**Agents** (Claude Code, claude.ai) connect via MCP to voicemode.dev.
13**Clients** (iOS app, web app) connect via WebSocket.
14The platform routes voice messages between them.
15 
16## Quick Setup
17 
18### 1. Add the MCP Server
19 
20Add to your Claude Code MCP settings (`~/.claude/settings.json`):
21 
22```json
23{
24  "mcpServers": {
25    "voicemode-dev": {
26      "command": "npx",
27      "args": ["-y", "mcp-remote", "https://voicemode.dev/mcp"]
28    }
29  }
30}
31```
32 
33### 2. Authenticate
34 
35When you first use a Connect tool, Claude Code will prompt for OAuth authentication. Sign in with your voicemode.dev account.
36 
37### 3. Connect a Client
38 
39Open the iOS app or web dashboard (voicemode.dev/dashboard) and sign in with the same account.
40 
41### 4. Start Talking
42 
43Use the `status` tool to see connected devices, then use `converse` to have a voice conversation.
44 
45## MCP Tools
46 
47| Tool | Description |
48|------|-------------|
49| `status` | Show connected devices and agents |
50| `converse` | Two-way voice conversation via connected client |
51 
52## Relationship to Local VoiceMode
53 
54| Feature | Local VoiceMode | VoiceMode Connect |
55|---------|-----------------|-------------------|
56| STT/TTS | Local (Whisper/Kokoro) | Client device (phone/browser) |
57| Setup | Install services | Just add MCP server |
58| Internet | Optional | Required |
59| Latency | Lower | Higher |
60| Mobile voice | No | Yes |
61 
62**Use both**: Local VoiceMode for desktop voice, Connect for mobile voice.
63 
64## Documentation
65 
66- [Overview](../../docs/connect/README.md) - What is VoiceMode Connect
67- [Architecture](../../docs/connect/architecture.md) - How agents and clients connect
68- [Claude Code Setup](../../docs/connect/setup/claude-code.md) - Detailed setup guide
69- [MCP Tools Reference](../../docs/connect/reference/mcp-tools.md) - Tool parameters
70 
71## Open Questions
72 
73- How do multiple agents on the same account interact?
74- What happens when multiple clients are connected?
75- How is the target device selected for `converse`?
76 
77These are documented in [docs/connect/](../../docs/connect/) as we learn more.
78