Voice MCP
About
Enables voice interactions with Claude and other LLMs using an OpenAI API key for STT/TTS services.
Details
- Author
- mbailey
- Categories
- Communication, Other, AI
Jump to
Setup
Install Voice MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/mbailey/voice-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Natural voice conversations with Claude Code (and other MCP capable agents)
VoiceMode enables natural voice conversations with Claude Code. Voice isn't about replacing typing - it's about being available when typing isn't.
- Walking to your next meeting
- Cooking while debugging
- Giving your eyes a break after hours of screen time
- Holding a coffee (or a dog)
- Any moment when your hands or eyes are busy
Requirements:Computer with microphone and speakers
Option 1: Claude Code Plugin (Recommended)
The fastest way for Claude Code users to get started:
# Add the VoiceMode marketplace claude plugin marketplace add mbailey/voicemode # Install VoiceMode plugin claude plugin install voicemode@voicemode ## Install dependencies (CLI, Local Voice Services) /voicemode:install # Start talking! /voicemode:converse
Installs dependencies and the VoiceMode Python package.
# Install UV package manager (if needed) curl -LsSf https://astral.sh/uv/install.sh | sh # Run the installer (sets up dependencies and local voice services) uvx voice-mode-install # Add to Claude Code claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher # Optional: Add OpenAI API key as fallback for local services export OPENAI_API_KEY=your-openai-key # Start a conversation claude converse
For manual setup, see theGetting Started Guide.
- 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
- Smart silence detection- stops recording when you stop speaking
- Privacy options- run entirely locally or use cloud services
Platforms:Linux, macOS, Windows (native or WSL), NixOSPython:3.10-3.14
VoiceMode works out of the box. For customization:
# Set OpenAI API key (if using cloud services) export OPENAI_API_KEY="your-key" # Or configure via file voicemode config edit
See theConfiguration Guidefor all options.
To use VoiceMode without permission prompts, add to~/.claude/settings.json:
{ "permissions": { "allow": [ "mcp__voicemode__converse", "mcp__voicemode__service" ] } }
See thePermissions Guidefor more options.
For privacy or offline use, install local speech services:
- Whisper.cpp- Local speech-to-text
- Kokoro- Local text-to-speech with multiple voices
These provide the same API as OpenAI, so VoiceMode switches seamlessly between them.
sudo apt update sudo apt install -y ffmpeg gcc libasound2-dev libasound2-plugins libportaudio2 portaudio19-dev pulseaudio pulseaudio-utils python3-dev
WSL2 users: The pulseaudio packages above are required for microphone access.
sudo dnf install alsa-lib-devel ffmpeg gcc portaudio portaudio-devel python3-devel
# Use development shell nix develop github:mbailey/voicemode # Or install system-wide nix profile install github:mbailey/voicemode
git clone https://github.com/mbailey/voicemode.git cd voicemode uv tool install -e .
# In /etc/nixos/configuration.nix environment.systemPackages = [ (builtins.getFlake "github:mbailey/voicemode").packages.${pkgs.system}.default ];
export VOICEMODE_SAVE_AUDIO=true # Files saved to ~/.voicemode/audio/YYYY/MM/
- Getting Started- Full setup guide
- Configuration- All environment variables
- Whisper Setup- Local speech-to-text
- Kokoro Setup- Local text-to-speech
- Development Setup- Contributing guide
- Website:voicemode.dev
- GitHub:github.com/mbailey/voicemode
- PyPI:pypi.org/project/voice-mode
- YouTube:@getvoicemode
- Twitter/X:@getvoicemode
- Newsletter:
Access GPT-5, Claude, Gemini and other models through a single MCP connection. Save development time and money on subscriptions.
Universal tool adapter — @tool decorator exports Python functions to OpenAI, Claude, Gemini, MCP, JSON Schema. Audit token costs.
Standing review layer for coding agents: Claude, GPT and Gemini debate each answer and return one recommendation plus the strongest dissent.
614 million contacts, live SMTP-verified. Invalid emails cost you $0. Connect Argorant with any Agent through CLI, MCP or API and build verified lists in Claude, GPT or Hermes.
AI-powered text-to-speech MCP server with instant voice cloning. Generate speech from Claude Desktop, Claude Code, or n8n using 5 built-in voices (English, German, French, Spanish) or clone any voice from a short audio sample. Runs fully local, no API keys, no cloud. Supports stdio, SSE, and HTTP transports.
Deepseek Thinking & Claude 3.5 Sonnet
Combines DeepSeek's reasoning capabilities with Claude 3.5 Sonnet's response generation through OpenRouter.
The production framework for Predictive and Generative AI. Serve any model as an API in one line, with OpenAI/Anthropic/Ollama-compatible endpoints, a built-in chat UI, and native MCP.
An MCP server that orchestrates Google Gemini and Claude Code models via the OpenRouter API.
Delegate bounded work from Claude to any OpenAI-compatible LLM endpoint (LM Studio, Ollama, OpenRouter), preserving your Claude context and quota.
Converts text summaries to speech using OpenAI's Text-to-Speech API and plays them in the background.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
