voice-mcp

"Voice Mode for Claude Code"

Runs on: Linux • macOS • Windows (WSL) | Python: 3.10+ | Tested: Ubuntu 24.04 LTS, Fedora 42

Overview

A Model Context Protocol (MCP) server that enables voice interactions with Claude and other LLMs. Built for simplicity and reliability, voice-mcp provides a clean interface for adding voice capabilities to your AI workflows.

See It In Action

Quick Start

                # Install and configure for Claude Code

claude mcp add --scope user voice-mcp uvx voice-mcp

export OPENAI_API_KEY=your-openai-key

claude

# Try it out

"Can you ask me a question using voice?"

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