How do I install Voicemode?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Voicemode need an API key?

The publisher lists these environment variables: OPENAI_API_KEY, VOICEMODE_DEBUG, VOICEMODE_SKIP_TTS, VOICEMODE_PREFER_LOCAL, VOICEMODE_AUDIO_FORMAT, VOICEMODE_WHISPER_MODEL, VOICEMODE_DISABLE_SILENCE_DETECTION.

What transport does Voicemode use?

Voicemode runs locally over stdio.

Voicemode MCP server

Q: When was Voicemode last checked?

Last checked 2026-11-11. Natural conversations - speak naturally, hear responses immediately. Works offline - optional local voice services (Whisper STT, Kokoro TTS). Low latency - fast enough to feel like a real conversation

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx voice-mode==9.0.2

Credentials from the publisher

OPENAI_API_KEY — 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 Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1OPENAI_API_KEY=<secret> VOICEMODE_DEBUG=<value> VOICEMODE_SKIP_TTS=<value> VOICEMODE_PREFER_LOCAL=<value> VOICEMODE_AUDIO_FORMAT=<value> VOICEMODE_WHISPER_MODEL=<value> VOICEMODE_DISABLE_SILENCE_DETECTION=<value> claude mcp add dev.voicemode-voicemode -- uvx voice-mode==9.0.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "dev.voicemode-voicemode": {4      "command": "uvx",5      "args": [6        "voice-mode==9.0.2"7      ],8      "env": {9        "OPENAI_API_KEY": "<secret>",10        "VOICEMODE_DEBUG": "<value>",11        "VOICEMODE_SKIP_TTS": "<value>",12        "VOICEMODE_PREFER_LOCAL": "<value>",13        "VOICEMODE_AUDIO_FORMAT": "<value>",14        "VOICEMODE_WHISPER_MODEL": "<value>",15        "VOICEMODE_DISABLE_SILENCE_DETECTION": "<value>"16      }17    }18  }19}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

Overview

About Voicemode

Natural conversations - speak naturally, hear responses immediately. Works offline - optional local voice services (Whisper STT, Kokoro TTS). Low latency - fast enough to feel like a real conversation

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Problem	Solution
No microphone access	Check terminal/app permissions. WSL2 needs pulseaudio packages.
UV not found	Run `curl -LsSf https://astral.sh/uv/install.sh \| sh`
OpenAI API error	Verify `OPENAI_API_KEY` is set correctly
No audio output	Check system audio settings and available devices

Voicemode

Add this server

Host a copy with our keys and logs.

Server facts

About Voicemode

Tools

Questions

How do I install Voicemode?

Does Voicemode need an API key?

What transport does Voicemode use?

When was Voicemode last checked?

Documentation

VoiceMode

See It In Action

Quick Start

Option 1: Claude Code Plugin (Recommended)

Key features

Option 2: Python installer package

Features

Compatibility

Configuration

Permissions Setup (Optional)

Local Voice Services

Installation Details

Ubuntu/Debian

Fedora/RHEL

macOS

NixOS

From source

NixOS system-wide

Troubleshooting

Save Audio for Debugging

Documentation

Links

License