MCP Server

dev.voicemode/voicemode MCP Server

Name: dev.voicemode/voicemode MCP Server
Author: dev.voicemode

dev.voicemode/voicemode

Repository Registry

What is the dev.voicemode/voicemode MCP server?

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

How to install dev.voicemode/voicemode

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENAI_API_KEY
secret
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)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "voicemode": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "VOICEMODE_DEBUG": "<YOUR_VOICEMODE_DEBUG>",
        "VOICEMODE_SKIP_TTS": "<YOUR_VOICEMODE_SKIP_TTS>",
        "VOICEMODE_PREFER_LOCAL": "<YOUR_VOICEMODE_PREFER_LOCAL>",
        "VOICEMODE_AUDIO_FORMAT": "<YOUR_VOICEMODE_AUDIO_FORMAT>",
        "VOICEMODE_WHISPER_MODEL": "<YOUR_VOICEMODE_WHISPER_MODEL>",
        "VOICEMODE_DISABLE_SILENCE_DETECTION": "<YOUR_VOICEMODE_DISABLE_SILENCE_DETECTION>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "voicemode": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "VOICEMODE_DEBUG": "<YOUR_VOICEMODE_DEBUG>",
        "VOICEMODE_SKIP_TTS": "<YOUR_VOICEMODE_SKIP_TTS>",
        "VOICEMODE_PREFER_LOCAL": "<YOUR_VOICEMODE_PREFER_LOCAL>",
        "VOICEMODE_AUDIO_FORMAT": "<YOUR_VOICEMODE_AUDIO_FORMAT>",
        "VOICEMODE_WHISPER_MODEL": "<YOUR_VOICEMODE_WHISPER_MODEL>",
        "VOICEMODE_DISABLE_SILENCE_DETECTION": "<YOUR_VOICEMODE_DISABLE_SILENCE_DETECTION>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "voicemode": {
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "VOICEMODE_DEBUG": "<YOUR_VOICEMODE_DEBUG>",
        "VOICEMODE_SKIP_TTS": "<YOUR_VOICEMODE_SKIP_TTS>",
        "VOICEMODE_PREFER_LOCAL": "<YOUR_VOICEMODE_PREFER_LOCAL>",
        "VOICEMODE_AUDIO_FORMAT": "<YOUR_VOICEMODE_AUDIO_FORMAT>",
        "VOICEMODE_WHISPER_MODEL": "<YOUR_VOICEMODE_WHISPER_MODEL>",
        "VOICEMODE_DISABLE_SILENCE_DETECTION": "<YOUR_VOICEMODE_DISABLE_SILENCE_DETECTION>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "voicemode": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "VOICEMODE_DEBUG": "<YOUR_VOICEMODE_DEBUG>",
        "VOICEMODE_SKIP_TTS": "<YOUR_VOICEMODE_SKIP_TTS>",
        "VOICEMODE_PREFER_LOCAL": "<YOUR_VOICEMODE_PREFER_LOCAL>",
        "VOICEMODE_AUDIO_FORMAT": "<YOUR_VOICEMODE_AUDIO_FORMAT>",
        "VOICEMODE_WHISPER_MODEL": "<YOUR_VOICEMODE_WHISPER_MODEL>",
        "VOICEMODE_DISABLE_SILENCE_DETECTION": "<YOUR_VOICEMODE_DISABLE_SILENCE_DETECTION>"
      }
    }
  }
}

Claude Code

claude mcp add voicemode --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env VOICEMODE_DEBUG=<YOUR_VOICEMODE_DEBUG> --env VOICEMODE_SKIP_TTS=<YOUR_VOICEMODE_SKIP_TTS> --env VOICEMODE_PREFER_LOCAL=<YOUR_VOICEMODE_PREFER_LOCAL> --env VOICEMODE_AUDIO_FORMAT=<YOUR_VOICEMODE_AUDIO_FORMAT> --env VOICEMODE_WHISPER_MODEL=<YOUR_VOICEMODE_WHISPER_MODEL> --env VOICEMODE_DISABLE_SILENCE_DETECTION=<YOUR_VOICEMODE_DISABLE_SILENCE_DETECTION> -- uvx voice-mode