Claude Code TTS Plugin
A Text-to-Speech MCP server plugin for Claude Code that converts text to speech using OpenAI's TTS API. Get audio feedback from Claude as you work!
Features
- Deterministic Auto-Speak: Every Claude response is automatically spoken (via Stop hook)
- 6 High-Quality Voices: alloy, echo, fable, onyx, nova, shimmer
- Worker Pool Architecture: Non-blocking queue with concurrent processing
- Mutex-Protected Playback: One audio plays at a time, no overlapping
- Cross-Platform: macOS (afplay), Linux (mpv/ffplay/mpg123), Windows (PowerShell)
- Standalone CLI:
speak-textbinary for direct TTS without MCP
Quick Install
# One-liner installation
curl -fsSL https://raw.githubusercontent.com/ybouhjira/claude-code-tts/main/install.sh | bashOr install manually:
git clone https://github.com/ybouhjira/claude-code-tts.git ~/.claude/plugins/claude-code-tts
cd ~/.claude/plugins/claude-code-tts
make installRequirements
- Go 1.21+ (for building from source)
- OpenAI API Key with TTS access
- Audio Player:
- macOS:
afplay(built-in) - Linux:
mpv,ffplay, ormpg123 - Windows: PowerShell (built-in)
- macOS:
