Voice Mode MCP Server

by mbaileydev.voicemode/voicemodev8.12.0

Natural voice conversations for AI assistants - STT/TTS via MCP

1.4kPythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active5d ago

Install Voice Mode MCP server

claude mcp add voice-mode -e OPENAI_API_KEY='<openai-api-key>' -- uvx voice-mode

{
  "mcpServers": {
    "voice-mode": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "voice-mode": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "voice-mode": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "voice-mode": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OPENAI_API_KEY	—	yes	OpenAI API key for cloud-based STT/TTS (optional - local services can be installed)
VOICEMODE_DEBUG	—	—	Enable debug mode with detailed logging (true/false)
VOICEMODE_SKIP_TTS	—	—	Skip TTS and show text only for faster response (true/false)
VOICEMODE_PREFER_LOCAL	—	—	Prefer local services over cloud when available (true/false, default: true)
VOICEMODE_AUDIO_FORMAT	—	—	Audio format: pcm, mp3, wav, flac, aac, opus (default: pcm)
VOICEMODE_WHISPER_MODEL	—	—	Whisper model: tiny, base, small, medium, large (default: base)
VOICEMODE_DISABLE_SILENCE_DETECTION	—	—	Disable silence detection for continuous recording (true/false)

Freshness

Active — last maintenance signal 5d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-04 · 5d ago · GitHub
Latest release
2026-07-21 · 3mo ago · GitHub · v8.12.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-21 · 3mo ago · official registry · v8.12.0

FAQ

›How do I install the Voice Mode MCP server in Claude Code?

Run: claude mcp add voice-mode -e OPENAI_API_KEY='<openai-api-key>' -- uvx voice-mode. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Voice Mode require an API key?

Yes. It expects OPENAI_API_KEY, of which 1 is a secret.

›Can I use Voice Mode as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Voice Mode in the official MCP registry?

Yes, as dev.voicemode/voicemode.