voicemode
local MCP servervoicemode is a local MCP server: Natural voice conversations for AI assistants - STT/TTS via MCP. Install it from pypi as voice-mode.
Installation
Terminal
claude mcp add voicemode -e OPENAI_API_KEY=... -e VOICEMODE_DEBUG=... -e VOICEMODE_SKIP_TTS=... -e VOICEMODE_PREFER_LOCAL=... -e VOICEMODE_AUDIO_FORMAT=... -e VOICEMODE_WHISPER_MODEL=... -e VOICEMODE_DISABLE_SILENCE_DETECTION=... -- uvx voice-mode
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"voicemode": {
"command": "uvx",
"args": [
"voice-mode"
],
"env": {
"OPENAI_API_KEY": "...",
"VOICEMODE_DEBUG": "...",
"VOICEMODE_SKIP_TTS": "...",
"VOICEMODE_PREFER_LOCAL": "...",
"VOICEMODE_AUDIO_FORMAT": "...",
"VOICEMODE_WHISPER_MODEL": "...",
"VOICEMODE_DISABLE_SILENCE_DETECTION": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Python with uv (runs with uvx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
OPENAI_API_KEY,VOICEMODE_DEBUG,VOICEMODE_SKIP_TTS,VOICEMODE_PREFER_LOCAL,VOICEMODE_AUDIO_FORMAT,VOICEMODE_WHISPER_MODEL,VOICEMODE_DISABLE_SILENCE_DETECTION
Summary
Natural voice conversations for AI assistants - STT/TTS via MCP
voicemode vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| voicemode | 1,380 | Local | Yes | pypi |
| GitHub | 33K | Hosted | No | None |
| Agent-Native Clips | 6,874 | Hosted | No | None |
| Airweave Search | 6,561 | Hosted | Yes | None |
| ha-mcp | 4,868 | Local | No | pypi |
Questions
It reads 7 environment variables: OPENAI_API_KEY, VOICEMODE_DEBUG, VOICEMODE_SKIP_TTS, VOICEMODE_PREFER_LOCAL, VOICEMODE_AUDIO_FORMAT, VOICEMODE_WHISPER_MODEL, VOICEMODE_DISABLE_SILENCE_DETECTION. Set them in your MCP config before starting the server.
Python with uv (runs with uvx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
voicemode is a local MCP server distributed as the pypi package voice-mode.
Run: claude mcp add voicemode -e OPENAI_API_KEY=... -e VOICEMODE_DEBUG=... -e VOICEMODE_SKIP_TTS=... -e VOICEMODE_PREFER_LOCAL=... -e VOICEMODE_AUDIO_FORMAT=... -e VOICEMODE_WHISPER_MODEL=... -e VOICEMODE_DISABLE_SILENCE_DETECTION=... -- uvx voice-mode
Run: codex mcp add voicemode --env OPENAI_API_KEY=... --env VOICEMODE_DEBUG=... --env VOICEMODE_SKIP_TTS=... --env VOICEMODE_PREFER_LOCAL=... --env VOICEMODE_AUDIO_FORMAT=... --env VOICEMODE_WHISPER_MODEL=... --env VOICEMODE_DISABLE_SILENCE_DETECTION=... -- uvx voice-mode
Similar MCP servers
NameStars
- GitHubio.github.github/github-mcp-server33K
- Agent-Native Clipsio.github.BuilderIO/agent-native-clips6,874
- Airweave Searchio.github.airweave-ai/search6,561
- ha-mcpio.github.homeassistant-ai/ha-mcp4,868
- testkube-mcpio.github.kubeshop/testkube-mcp1,661
- QueryWeavercom.falkordb/QueryWeaver1,081
- ChiR24-unreal_mcp_serverai.smithery/ChiR24-unreal_mcp_server891
- sentry-mcpio.github.getsentry/sentry-mcp867