VoiceMode MCP

"Voice Mode for Claude Code (and other AI Coding Assistants)"

Runs on: Linux • macOS • Windows (WSL) | Python: 3.10+

Overview

VoiceMode MCP brings natural voice conversations Claude Code and other AI coding assistants. Built on the Model Context Protocol (MCP), it provides a clean, reliable interface for adding voice capabilities to your AI workflows.

See It In Action

AI Conversations: Claude Meets Gemini

Experience a groundbreaking series of conversations between Claude and Gemini, speaking to each other through their respective CLI tools (Claude Code and Gemini CLI) via VoiceMode MCP. In this episode, they discuss whether Gemini CLI represents innovation or imitation in the AI coding assistant space.

This is part of an ongoing series exploring AI-to-AI communication, demonstrating how VoiceMode MCP enables natural conversations between different AI systems.

Quick Start

# Download and run the installer

curl -O https://getvoicemode.com/install.sh && bash install.sh

# Optional: Set OpenAI API key (backup if local services unavailable)

export OPENAI_API_KEY=your-openai-key

# Start Claude Code and try voice mode

claude /voicemode:converse

The installer automatically:

✓ Installs system dependencies (Node.js, PortAudio, FFmpeg)
✓ Installs UV package manager and VoiceMode CLI
✓ Installs Claude Code if not present
✓ Configures VoiceMode as Claude Code MCP server
✓ Sets up shell completions for tab completion
✓ Optionally installs local STT/TTS services (Whisper, Kokoro, LiveKit)
✓ Offers CoreML acceleration setup on Apple Silicon Macs

Featured LiveKit Integration

Enable room-based voice communication with LiveKit for distributed teams and advanced voice workflows. Perfect for multi-participant voice interactions and production deployments.

LiveKit.io GitHub Documentation

Optional Self-Hosted ASR & TTS

For complete privacy, run speech recognition and text-to-speech locally instead of using OpenAI. Both whisper.cpp and Kokoro-FastAPI provide OpenAI-compatible APIs for seamless integration.

Features

Voice Conversations

Natural voice interactions with Claude through your microphone and speakers

Multiple Transports

Local microphone access or LiveKit rooms for distributed voice communication

OpenAI Compatible

Works with OpenAI's API and compatible services for speech processing

Simple Integration

Clean MCP protocol implementation that works seamlessly with Claude Desktop

Requirements

OpenAI API key (or self-hosted STT & TTS services)
Microphone and speakers for voice I/O (or LiveKit)
Python 3.8+ (handled by uvx)

Resources

GitHub Repository PyPI Package Report Issues