VoiceMode

Voice for Claude Code

Stop typing.
Start talking.

Natural, hands-free voice conversations with Claude Code and other AI coding assistants — local, private, and free.

Get started View on GitHub
Runs on Linux · macOS · Windows (WSL) • Python 3.10+ • MIT licensed
YOU"Refactor the auth handler to use the new token helper."
VMOn it — pulling auth-handler.ts now. Want me to keep the old function as a deprecated alias?
YOU"Yeah, alias it for one release."

From the podcast

Fantasy Focus Group

Hear VoiceMode's voice cloning in action: a focus group of cloned voices (Attenborough, Fleabag, Cookie Monster, Homer) review VoiceMode while Mike makes dinner, hands-free. Thirteen ramshackle minutes, more bloopers reel than demo — the clones fray as it runs, and Cookie Monster fully short-circuits near the end.

0:00 / 13:03 Full episode ↗

Quick start

Get talking today

Two ways in. The Claude Code plugin is the fastest; the Python installer wires VoiceMode in as an MCP server.

Recommended

Claude Code plugin

# Add the VoiceMode marketplace claude plugin marketplace add mbailey/voicemode # Install the plugin claude plugin install voicemode@voicemode # Install local voice services /voicemode:install # Start talking! /voicemode:converse
Alternative

Python installer (MCP server)

# Install uv, then VoiceMode curl -LsSf https://astral.sh/uv/install.sh | sh uvx voice-mode-install # Add VoiceMode to Claude claude mcp add --scope user voicemode \ -- uvx --refresh voice-mode # Start a voice conversation claude converse

The installer checks dependencies (PortAudio, FFmpeg), sets up shell completions, and configures optional local Whisper + Kokoro services. Full steps in the Getting Started guide.

Why VoiceMode

Built for the way you actually work

Real voice conversations

Natural back-and-forth with Claude through your mic and speakers — laptop, AirPods, whatever you've got.

OpenAI-compatible

Works with OpenAI's API or any compatible service for speech — swap providers without touching your setup.

Clean MCP integration

A reliable Model Context Protocol server that drops into Claude Code and Claude Desktop without ceremony.

Resources

Dig deeper

GitHub repository PyPI package Report an issue Newsletter