converseLABSCO SUMMARY
Voice is about being available when typing is not.
Walking to a meeting, cooking, holding a coffee — the agent is still reachable. And with Whisper and Kokoro installed locally, nothing you say has to leave the machine to get there.
What it is
A voice layer for Claude Code and other MCP-capable agents. Speech comes in, speech goes out, with silence detection deciding when you have finished talking.
What you get
converse— the tool the agent calls to speak and listen, andservicefor managing the underlying voice services- Local speech services that work offline: Whisper.cpp for speech-to-text and Kokoro for text-to-speech with several voices, both presenting the same API as OpenAI so the switch between them is seamless
- Smart silence detection that stops recording when you stop speaking, and latency low enough for the exchange to feel like a conversation
- A Claude Code plugin with
/voicemode:installand/voicemode:converseslash commands - Configuration through
voicemode config edit, covering audio format, Whisper model size, whether to prefer local services, and skipping TTS for a text-only reply
Requirements
A computer with a microphone and speakers, and Python between 3.10 and 3.14. Linux, macOS, Windows (native or WSL) and NixOS are supported. The quickest route for Claude Code users is the plugin: claude plugin marketplace add mbailey/voicemode then claude plugin install voicemode@voicemode, followed by /voicemode:install to pull in the CLI and the local voice services. Otherwise install uv and run uvx voice-mode-install, then claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher. OPENAI_API_KEY is optional and acts as a fallback when the local services are not available. To avoid permission prompts, allow mcp__voicemode__converse and mcp__voicemode__service in ~/.claude/settings.json.
Setup effort
One command — claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher
USE CASES
Working while your hands are busy
Ask, listen and answer without a keyboard — the point is availability in the moments when the screen is not.
Keeping the conversation off the network
Whisper.cpp and Kokoro run locally and present the same API as the cloud services, so switching to fully local costs a setup step, not a rewrite.
Resting your eyes after a long session
Spoken replies rather than another screen of text, with silence detection handling the turn-taking.
Getting set up in one command
The Claude Code plugin installs the CLI and the local voice services through /voicemode:install, then /voicemode:converse starts talking.
Managing the voice services afterwards
The service tool covers starting, checking and controlling the local speech services from inside the conversation.
4 tools
Listed in project docs. Your client may show a different list.
serviceconchvoice_registryBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
Python 3.10
INSTALLATION
Connect your client
Server setup
claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcherMCP Clients
Claude Code — plugin
claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemodeClaude Code — HTTP
Install the VoiceMode CLI and local voice services
uvx voice-mode-installStart VoiceMode as an HTTP server — it listens on http://127.0.0.1:8765/mcp
voicemode serveThen add it to Claude Code
claude mcp add --scope user --transport http voicemode http://127.0.0.1:8765/mcpClaude Desktop — mcp-remote
Install the VoiceMode CLI and local voice services
uvx voice-mode-installStart VoiceMode as an HTTP server — it listens on http://127.0.0.1:8765/mcp
voicemode serveThen add this to claude_desktop_config.json
{
"mcpServers": {
"voicemode": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"http://127.0.0.1:8765/mcp"
]
}
}
}Claude.ai, Claude Cowork
VoiceMode's docs mark this route experimental. Claude.ai and Claude Cowork connect through a custom connector, so the server has to be reachable from the internet; the documented way is Tailscale Funnel
Install the VoiceMode CLI and local voice services
uvx voice-mode-installYou need a Tailscale account, the Tailscale client running, and Funnel enabled for your tailnet (add "funnel" to your ACL policy in the Tailscale admin console)
sudo tailscale up
tailscale funnel 8765
voicemode serve --allow-anthropic --secret <YOUR_SECRET_UUID>In Claude.ai settings, add a custom MCP connector — URL: https://<YOUR_MACHINE>.tail12345.ts.net/mcp/<YOUR_SECRET_UUID>, Name: VoiceMode