Log inSubmit server
Voicemode logo

Voicemode

Adds microphone input and spoken responses to MCP-capable AI assistants through local or cloud speech services.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Voicemode

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "voicemode": {
      "command": "uvx",
      "args": [
        "voice-mode-install"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

voicemode MCP server connects MCP-capable assistants to microphone input and audio output for spoken conversations. It provides conversation and service tools, using speech-to-text and text-to-speech through OpenAI-compatible cloud services or optional local Whisper.cpp and Kokoro services. Reach for it when hands-free interaction, offline voice processing, or reduced screen use matters. Claude Code has a dedicated plugin and command-line setup path.

Use cases

  • Start hands-free conversations with Claude Code
  • Use local Whisper.cpp and Kokoro services for offline voice interaction
  • Debug microphone and audio output problems by saving recordings
  • Talk to an AI assistant while cooking, walking, or away from the keyboard

Key features

  • MCP voice conversation tool
  • Speech-to-text and text-to-speech
  • Optional local Whisper.cpp and Kokoro services
  • Silence detection for recording control
  • Claude Code plugin and Python installer
  • Configurable audio capture for debugging

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

43/48 checks healthy over the last 91d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · voice-mode-install (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1.4kStargazers on the source repository.
Last commitTodayMost recent push to the default branch.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Voicemode works

What voicemode does

voicemode adds spoken interaction to AI assistants that support MCP. It captures speech through the computer microphone, sends it through a speech-to-text service, and produces spoken responses through text-to-speech. The main interaction is exposed through the converse MCP tool, while the service tool supports the voice-service workflow.

The package is intended for conversational use rather than replacing typed interaction. It can be useful while walking, cooking, or working away from the keyboard, and it includes silence detection to stop recording after speech ends.

Voice processing can use cloud services or local components. Whisper.cpp provides local speech recognition, while Kokoro provides local speech synthesis with multiple voices. These local services follow the same API shape as the OpenAI services, allowing VoiceMode to switch between them.

How it works

A compatible assistant starts the VoiceMode MCP launcher over stdio. The assistant invokes the conversation capability, VoiceMode reads audio from the configured microphone, detects when speaking has stopped, and returns or plays the resulting interaction through the configured audio device.

The project supports Linux, macOS, Windows, Windows Subsystem for Linux, and NixOS. Python versions 3.10 through 3.14 are supported. A computer with a microphone and speakers is required.

Claude Code users can install the VoiceMode marketplace plugin and invoke /voicemode:install followed by /voicemode:converse. An alternative setup uses the Python installer package and registers voicemode-mcp-launcher with claude mcp add.

Setup and configuration

The installer can set up the Python package, command-line tools, dependencies, and local voice services. The documented installation path uses uv; installing it first may be necessary. Manual source installation and NixOS development or system-wide installation are also available.

Cloud speech services use OPENAI_API_KEY. The key is optional when local voice services are configured. Configuration can also be edited with voicemode config edit.

Platform dependencies include audio and media packages. Ubuntu and Debian setups may need FFmpeg, PortAudio, ALSA, PulseAudio, and development packages; Fedora and RHEL use their corresponding ALSA and PortAudio packages. macOS setup uses Homebrew packages including FFmpeg and PortAudio. WSL2 users need PulseAudio packages for microphone access.

Claude Code permission rules can allow the converse and service MCP tools without repeated prompts. For debugging, setting VOICEMODE_SAVE_AUDIO=true saves recordings under ~/.voicemode/audio/YYYY/MM/.

Tools and capabilities

  • converse for voice conversations between the user and the connected assistant.
  • service for the VoiceMode service workflow.
  • Speech-to-text through OpenAI-compatible services or local Whisper.cpp.
  • Text-to-speech through OpenAI-compatible services or local Kokoro voices.
  • Silence detection that ends recording after the user stops speaking.
  • Local operation for offline use and privacy-sensitive deployments.
  • Optional audio capture for troubleshooting.

Limitations and notes

Audio access depends on operating-system permissions and an available microphone and output device. Cloud operation requires a correctly configured OpenAI API key. Local operation requires installing the relevant Whisper.cpp and Kokoro services. WSL2 needs additional PulseAudio support for microphone access.

The setup documentation focuses on Claude Code, although the server is designed for other MCP-capable agents as well. VoiceMode is released under the MIT license.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Voicemode

voicemode is an MCP server that connects AI assistants to a computer microphone and speakers for spoken conversations. Its main tools are `converse` for voice interaction and `service` for managing the voice-service workflow. It supports OpenAI-compatible cloud speech services plus optional local Whisper.cpp and Kokoro components.

Install it through the Claude Code plugin or the Python installer package. The plugin path adds the VoiceMode marketplace and runs `/voicemode:install`; the Python path uses `uvx voice-mode-install`, then registers `voicemode-mcp-launcher` with `claude mcp add`.

Yes, voicemode can work offline with local Whisper.cpp speech-to-text and Kokoro text-to-speech services. Install and configure those local services instead of relying on cloud speech providers.

voicemode supports Linux, macOS, Windows, Windows Subsystem for Linux, and NixOS. Audio packages and microphone permissions vary by platform, and WSL2 requires PulseAudio packages for microphone access.

Set `OPENAI_API_KEY` in the environment before starting the assistant, for example with `export OPENAI_API_KEY="your-key"`. The key is used for cloud voice services and is optional when local services are configured.

Related MCP servers

All in Conversational AI All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewVoicemode AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/voicemode?style=directory)](https://allmcps.com/mcp/voicemode)
HTML Embed
<a href="https://allmcps.com/mcp/voicemode"><img src="https://allmcps.com/api/badge/voicemode?style=directory" alt="Voicemode on AllMCPs" /></a>