About voicemode-connect
voicemode-connect is a skill for voice conversations between AI assistants and the voicemode.dev cloud platform. Claude Code or claude.ai connects over MCP, while the iOS and web clients carry the voice conversation without local STT/TTS services.
Key features
- 01Check connected devices and agents
- 02Hold two-way voice conversations
- 03Use iOS and web voice clients
- 04Route voice messages through voicemode.dev
Use cases
- 01Talk with an assistant from an iOS app
- 02Use browser-based voice conversations
- 03Add mobile voice without local STT/TTS
MCP support
The skill connects Claude Code or claude.ai to voicemode.dev through MCP. Its `status` and `converse` tools show connections and support voice conversations through connected clients.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/voicemode-connectin Claude Code to confirm it loaded.
Details
From the project READMEVoiceMode 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.