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