Voice Mode
Natural voice conversations for AI assistants that brings human-like voice interactions to Claude, ChatGPT, and other LLMs through the Model Context Protocol (MCP).
What is Voice Mode?
Voice Mode is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to natural voice conversations for ai assistants that brings human-like voice interactions to claude, chatgpt, and other llms through the model context protocol (mcp).
Natural voice conversations for AI assistants that brings human-like voice interactions to Claude, ChatGPT, and other LLMs through the Model Context Protocol (MCP).
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Natural voice conversations for AI assistants that brings hu
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx voice-modeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Voice Mode
VoiceMode is a Python-based MCP server that adds natural voice conversation to Claude Code and other MCP-compatible AI assistants, enabling hands-free spoken interaction through two tools: converse (to start a voice exchange) and service (to manage background voice processes). It supports both fully local operation using Whisper.cpp for speech-to-text and Kokoro for text-to-speech, and cloud fallback using the OpenAI API — making it useful for developers who want to dictate code, ask questions while cooking or walking, or reduce eye strain during long coding sessions.
Prerequisites
- Python 3.10 to 3.14 installed
- uv package manager installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
- A microphone and speakers connected to your computer
- Claude Code or another MCP-compatible client
- Optional: OPENAI_API_KEY if using cloud-based speech services instead of local
Install system audio dependencies
VoiceMode requires audio libraries that differ by operating system. Install the appropriate packages for your platform before installing the Python package.
# macOS
brew install ffmpeg node portaudio
# Ubuntu/Debian
sudo apt install -y ffmpeg gcc libasound2-dev libportaudio2 portaudio19-dev pulseaudioRun the VoiceMode installer
The installer package sets up the VoiceMode Python package, local voice services (Whisper STT and Kokoro TTS), and all dependencies in a single step.
uvx voice-mode-installAdd VoiceMode to Claude Code as an MCP server
Register the VoiceMode MCP server with Claude Code using the mcp add command. The --scope user flag makes it available across all your projects.
claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcherSet OpenAI API key as cloud fallback (optional)
If local voice services are unavailable or you prefer cloud quality, export your OpenAI API key. VoiceMode will use OpenAI Whisper and TTS when local services are not running.
export OPENAI_API_KEY="your-openai-api-key"Start a voice conversation
With Claude Code running, trigger a voice session. Claude will listen through your microphone, process your speech, respond in voice, and continue the conversation naturally.
claude converseVoice Mode Examples
Client configuration
Manual MCP configuration for claude_desktop_config.json if you prefer to configure VoiceMode directly rather than via the claude mcp add command.
{
"mcpServers": {
"voicemode": {
"command": "uvx",
"args": ["--refresh", "--from", "voice-mode", "voicemode-mcp-launcher"],
"env": {
"OPENAI_API_KEY": "your-openai-api-key",
"VOICEMODE_SAVE_AUDIO": "true"
}
}
}
}Prompts to try
Example spoken prompts and MCP tool invocations once VoiceMode is connected.
- "Start a voice conversation" (triggers mcp__voicemode__converse)
- "Check the status of the background voice services" (triggers mcp__voicemode__service)
- Speak naturally: "Explain what this function does and suggest how to make it faster"
- Speak naturally: "What tests should I write for the checkout module?"
- Speak naturally: "I'm walking to a meeting — summarize the last hour of our coding session"Troubleshooting Voice Mode
No microphone input detected or recording is silent
On macOS, grant microphone permission to Terminal or your MCP client in System Settings → Privacy & Security → Microphone. On Ubuntu/WSL2, ensure pulseaudio is installed and running: `pulseaudio --start`.
uvx command not found after installing uv
Run `curl -LsSf https://astral.sh/uv/install.sh | sh` to install uv, then close and reopen your terminal so the PATH update takes effect. Verify with `which uvx`.
OpenAI API errors when using cloud voice services
Verify OPENAI_API_KEY is set correctly and the key has access to the Whisper and TTS APIs. To debug audio issues, set VOICEMODE_SAVE_AUDIO=true and inspect the saved files in ~/.voicemode/audio/.
Frequently Asked Questions about Voice Mode
What is Voice Mode?
Voice Mode is a Model Context Protocol (MCP) server that natural voice conversations for ai assistants that brings human-like voice interactions to claude, chatgpt, and other llms through the model context protocol (mcp). It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Voice Mode?
Follow the installation instructions on the Voice Mode GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Voice Mode?
Voice Mode works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Voice Mode free to use?
Yes, Voice Mode is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Voice Mode Alternatives — Similar Communication Servers
Looking for alternatives to Voice Mode? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Voice Mode in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Voice Mode?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.