Happy slice of mcp pizzaMCP.pizza

voicemode

MCP.Pizza Chef: mbailey

Speak your questions instead of typing them, and hear the assistant read its replies back to you in a natural voice, all inside Claude Code. It can run completely offline using free, built-in speech engines for privacy, or you can add a free OpenAI account for faster, cloud-based voices. It is especially handy for hands-free moments, like cooking, walking to a meeting, or giving your eyes a rest after a long stretch at the screen.

Coding
Communication

Use This MCP server To

Have a spoken back-and-forth conversation with my assistant Ask a question out loud while my hands are busy Listen to a response instead of reading it on screen Keep working hands-free while cooking or walking Give my eyes a break from staring at the screen Talk through an idea out loud instead of typing it

README

VoiceMode

Natural voice conversations with Claude Code (and other MCP capable agents)

PyPI Downloads PyPI Downloads PyPI Downloads

VoiceMode enables natural voice conversations with Claude Code. Voice isn't about replacing typing - it's about being available when typing isn't.

Perfect for:

  • Walking to your next meeting
  • Cooking while debugging
  • Giving your eyes a break after hours of screen time
  • Holding a coffee (or a dog)
  • Any moment when your hands or eyes are busy

See It In Action

VoiceMode Demo

Quick Start

Requirements: Computer with microphone and speakers

Option 1: Claude Code Plugin (Recommended)

The fastest way for Claude Code users to get started:

# Add the VoiceMode marketplace
claude plugin marketplace add mbailey/voicemode

# Install VoiceMode plugin
claude plugin install voicemode@voicemode

## Install dependencies (CLI, Local Voice Services)

/voicemode:install

# Start talking!
/voicemode:converse

Option 2: Python installer package

Installs dependencies and the VoiceMode Python package.

voicemode FAQ

Can I use this to have a hands-free conversation with my assistant?
Yes — you can speak your questions out loud and hear the replies read back to you, without touching the keyboard.
Can I use this without an internet connection?
Yes — it can run entirely on your own computer using free, built-in speech tools, so no account or internet connection is required.
Which apps does this work in?
It is built for Claude Code, and it also works with other AI tools that support the same connection standard, including assistants built on Gemini or OpenAI models.
Do I need an account or an API key?
No account is required for the offline option. If you want faster, cloud-based voices, you can optionally add a free OpenAI key.
How hard is it to set up?
It takes a short setup step where you paste one small command into your app's settings, so it is easier than a full developer installation but not fully automatic.
Do I need any special hardware?
Just a computer with a working microphone and speakers — no extra equipment is required.
Will people around me be able to hear my conversation?
Yes — voice conversations happen out loud through your speakers, so it works best somewhere you are comfortable talking, or with headphones for privacy.
Can I switch back to typing whenever I want?
Yes — voice is an option alongside typing, so you can switch back at any time.