How does the automatic TTS feature work?

A Stop hook extracts and speaks the first sentence of every Claude response automatically in the background.

What audio players are supported on different platforms?

macOS uses afplay, Linux supports mpv, ffplay, or mpg123, and Windows uses PowerShell for audio playback.

Is an OpenAI API key required?

Yes, an OpenAI API key with TTS access must be set in the environment variable OPENAI_API_KEY.

Can I use this TTS server without MCP?

Yes, a standalone CLI binary 'speak-text' is provided for direct text-to-speech usage.

Claude Code Tts

ttsopenaiaudiocross-platformclaude-code

MCP server plugin converting text to speech via OpenAI TTS API with 6 voices and cross-platform audio playback.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for ybouhjira/claude-code-tts, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Overview

This MCP server plugin for Claude Code converts text responses into speech using OpenAI's TTS API. It supports six distinct voices and uses a worker pool to handle concurrent TTS requests without blocking. Playback is mutex-protected to ensure audio does not overlap, and it supports macOS, Linux, and Windows audio players. It also includes an automatic TTS feature that speaks the first sentence of every Claude response via a Stop hook.

Use cases

Convert Claude AI text responses to spoken audio

Automatically play the first sentence of each Claude response

Use different voice styles for TTS output

Run TTS jobs concurrently without blocking the main process

Invoke TTS directly from the standalone CLI without MCP

Key features

Integration with OpenAI TTS API (model tts-1)

Six selectable voices: alloy, echo, fable, onyx, nova, shimmer

Worker pool architecture with queue for concurrent processing

Mutex-protected audio playback to prevent overlapping sounds

Cross-platform audio playback support (afplay, mpv, ffplay, mpg123, PowerShell)

Automatic deterministic TTS via Stop hook in Claude Code

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Claude Code Tts.

Extracted Tool Capabilities

Integration with OpenAI TTS API (model tts-1)

Six selectable voices: alloy, echo, fable, onyx, nova, shimmer

Worker pool architecture with queue for concurrent processing

Mutex-protected audio playback to prevent overlapping sounds

Cross-platform audio playback support (afplay, mpv, ffplay, mpg123, PowerShell)

Automatic deterministic TTS via Stop hook in Claude Code

Documentation Overview

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!

Demo

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-text binary for direct TTS without MCP

Quick Install

bash

# One-liner installation
curl -fsSL https://raw.githubusercontent.com/ybouhjira/claude-code-tts/main/install.sh | bash

Or install manually:

bash

git clone https://github.com/ybouhjira/claude-code-tts.git ~/.claude/plugins/claude-code-tts
cd ~/.claude/plugins/claude-code-tts
make install

Requirements

Go 1.21+ (for building from source)
OpenAI API Key with TTS access
Audio Player:
- macOS: afplay (built-in)
- Linux: mpv, ffplay, or mpg123
- Windows: PowerShell (built-in)

Configuration

Set your OpenAI API key:

server.ts

export OPENAI_API_KEY="sk-..."

Or add to your shell profile (~/.zshrc or ~/.bashrc).

Architecture

Code

┌─────────────────────────────────────────────────────────────┐
│                     Claude Code                              │
│                         │                                    │
│                    MCP Protocol                              │
│                         │                                    │
│  ┌──────────────────────▼──────────────────────────────┐    │
│  │              TTS MCP Server (Go)                     │    │
│  │  ┌─────────────────────────────────────────────┐    │    │
│  │  │              Tool Handlers                   │    │    │
│  │  │   speak(text, voice)  │  tts_status()       │    │    │
│  │  └─────────────┬─────────┴─────────────────────┘    │    │
│  │                │                                     │    │
│  │  ┌─────────────▼─────────────────────────────┐      │    │
│  │  │           Worker Pool (2 workers)          │      │    │
│  │  │  ┌─────────┐    ┌─────────────────────┐   │      │    │
│  │  │  │ Job     │───►│ Queue (50 slots)    │   │      │    │
│  │  │  │ Submit  │    └──────────┬──────────┘   │      │    │
│  │  │  └─────────┘               │              │      │    │
│  │  │                   ┌────────▼────────┐     │      │    │
│  │  │                   │ Worker 1 │ 2    │     │      │    │
│  │  │                   └────────┬────────┘     │      │    │
│  │  └────────────────────────────│──────────────┘      │    │
│  │                               │                      │    │
│  │  ┌────────────────────────────▼──────────────────┐  │    │
│  │  │              OpenAI TTS API                    │  │    │
│  │  │         POST /v1/audio/speech                  │  │    │
│  │  │         Model: tts-1                           │  │    │
│  │  └───────────────────┬────────────────────────────┘  │    │
│  │                      │                               │    │
│  │  ┌───────────────────▼────────────────────────────┐  │    │
│  │  │         Audio Player (Mutex Protected)          │  │    │
│  │  │   macOS: afplay │ Linux: mpv │ Win: PowerShell  │  │    │
│  │  └─────────────────────────────────────────────────┘  │    │
│  └──────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘

Usage

speak(text, voice)

Convert text to speech and play it aloud.

Parameters:

Parameter	Type	Required	Description
`text`	string	Yes	Text to speak (max 4096 chars)
`voice`	string	No	Voice to use (default: alloy)

Available Voices:

Voice	Description
`alloy`	Neutral, balanced
`echo`	Male, warm
`fable`	British accent
`onyx`	Deep male
`nova`	Female, friendly
`shimmer`	Soft female

Example:

Code

Use the speak tool to say "Build completed successfully!" with the nova voice.

tts_status()

Get the current status of the TTS system.

Returns:

config.json

{
  "worker_count": 2,
  "queue_size": 50,
  "queue_pending": 0,
  "total_processed": 15,
  "total_failed": 0,
  "is_playing": false,
  "recent_jobs": [...]
}

Automatic TTS (Deterministic)

This plugin includes a Stop hook that automatically speaks the first sentence of every Claude response. No configuration needed - it just works.

How it works:

Code

Claude responds → Stop hook fires → First sentence extracted → Audio plays

The hook runs in the background and won't block Claude's responses.

speak-text CLI

A standalone binary for direct TTS without going through MCP:

bash

# Basic usage
speak-text "Hello world"

# With voice selection
speak-text -voice onyx "Error occurred"

Located at ~/.claude/plugins/claude-code-tts/bin/speak-text after installation.

Project Structure

Code

claude-code-tts/
├── cmd/
│   ├── tts-server/
│   │   └── main.go           # MCP server entry point
│   └── speak-text/
│       └── main.go           # Standalone CLI binary
├── hooks/
│   └── auto-speak.sh         # Stop hook for deterministic TTS
├── internal/
│   ├── audio/
│   │   └── player.go         # Cross-platform audio playback
│   ├── server/
│   │   ├── server.go         # MCP server & tool handlers
│   │   └── worker.go         # Worker pool implementation
│   └── tts/
│       └── openai.go         # OpenAI TTS client
├── plugin.json                # Plugin metadata + hook config
├── Makefile                   # Build automation
└── install.sh                 # One-liner installer

Building from Source

bash

# Clone the repository
git clone https://github.com/ybouhjira/claude-code-tts.git
cd claude-code-tts

# Build
make build

# Install to Claude Code plugins
make install

# Run tests
make test

Troubleshooting

"OPENAI_API_KEY environment variable is required"

Set your OpenAI API key:

server.ts

export OPENAI_API_KEY="sk-..."

"No suitable audio player found on Linux"

Install one of: mpv, ffplay, or mpg123:

bash

# Ubuntu/Debian
sudo apt install mpv

# Fedora
sudo dnf install mpv

# Arch
sudo pacman -S mpv

Audio not playing on macOS

Check that afplay works:

bash

# Test with a sample audio file
afplay /System/Library/Sounds/Ping.aiff

Queue is full

The default queue size is 50. If you're hitting this limit:

Wait for current jobs to complete
Check tts_status() to see pending jobs
The queue will drain as jobs are processed

High latency

OpenAI TTS API typically takes 1-3 seconds per request
Audio files must download completely before playing
Consider keeping messages short for faster feedback

API Costs

This plugin uses OpenAI's tts-1 model:

Cost: ~$0.015 per 1,000 characters
Example: "Hello, world!" (13 chars) = ~$0.0002

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Credits

OpenAI TTS API
mcp-go - Go MCP implementation
Model Context Protocol

Read the full README →View source on GitHub →

Related MCP Servers

View all in Text-to-Speech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

7mo ago

Most recent push to the default branch.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Claude Code Tts

Six voices: alloy (neutral), echo (male warm), fable (British accent), onyx (deep male), nova (female friendly), shimmer (soft female).

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ybouhjira-claude-code-tts?style=directory)](https://allmcps.com/mcp/ybouhjira-claude-code-tts)

HTML Embed

<a href="https://allmcps.com/mcp/ybouhjira-claude-code-tts"><img src="https://allmcps.com/api/badge/ybouhjira-claude-code-tts?style=directory" alt="Claude Code Tts on AllMCPs" /></a>

Technical Specs & Signals

CategoryText-to-Speech

PricingBring your own API key (usage-based cost)

9/10 checks healthy over the last 32d

43Quality signal: Fair · 43/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools19/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🎧 Text-to-Speech →Alternatives to Claude Code Tts →Install in Claude Desktop Install in Cursor Install in VS Code

Claude Code Tts

ttsopenaiaudiocross-platformclaude-code

MCP server plugin converting text to speech via OpenAI TTS API with 6 voices and cross-platform audio playback.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Overview

Use cases

Convert Claude AI text responses to spoken audio

Automatically play the first sentence of each Claude response

Use different voice styles for TTS output

Run TTS jobs concurrently without blocking the main process

Invoke TTS directly from the standalone CLI without MCP

Key features

Integration with OpenAI TTS API (model tts-1)

Six selectable voices: alloy, echo, fable, onyx, nova, shimmer

Worker pool architecture with queue for concurrent processing

Mutex-protected audio playback to prevent overlapping sounds

Cross-platform audio playback support (afplay, mpv, ffplay, mpg123, PowerShell)

Automatic deterministic TTS via Stop hook in Claude Code

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Claude Code Tts.

Extracted Tool Capabilities

Integration with OpenAI TTS API (model tts-1)

Six selectable voices: alloy, echo, fable, onyx, nova, shimmer

Worker pool architecture with queue for concurrent processing

Mutex-protected audio playback to prevent overlapping sounds

Cross-platform audio playback support (afplay, mpv, ffplay, mpg123, PowerShell)

Automatic deterministic TTS via Stop hook in Claude Code

Documentation Overview

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!

Demo

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-text binary for direct TTS without MCP

Quick Install

bash

# One-liner installation
curl -fsSL https://raw.githubusercontent.com/ybouhjira/claude-code-tts/main/install.sh | bash

Or install manually:

bash

git clone https://github.com/ybouhjira/claude-code-tts.git ~/.claude/plugins/claude-code-tts
cd ~/.claude/plugins/claude-code-tts
make install

Requirements

Go 1.21+ (for building from source)
OpenAI API Key with TTS access
Audio Player:
- macOS: afplay (built-in)
- Linux: mpv, ffplay, or mpg123
- Windows: PowerShell (built-in)

Configuration

Set your OpenAI API key:

server.ts

export OPENAI_API_KEY="sk-..."

Or add to your shell profile (~/.zshrc or ~/.bashrc).

Architecture

Code

┌─────────────────────────────────────────────────────────────┐
│                     Claude Code                              │
│                         │                                    │
│                    MCP Protocol                              │
│                         │                                    │
│  ┌──────────────────────▼──────────────────────────────┐    │
│  │              TTS MCP Server (Go)                     │    │
│  │  ┌─────────────────────────────────────────────┐    │    │
│  │  │              Tool Handlers                   │    │    │
│  │  │   speak(text, voice)  │  tts_status()       │    │    │
│  │  └─────────────┬─────────┴─────────────────────┘    │    │
│  │                │                                     │    │
│  │  ┌─────────────▼─────────────────────────────┐      │    │
│  │  │           Worker Pool (2 workers)          │      │    │
│  │  │  ┌─────────┐    ┌─────────────────────┐   │      │    │
│  │  │  │ Job     │───►│ Queue (50 slots)    │   │      │    │
│  │  │  │ Submit  │    └──────────┬──────────┘   │      │    │
│  │  │  └─────────┘               │              │      │    │
│  │  │                   ┌────────▼────────┐     │      │    │
│  │  │                   │ Worker 1 │ 2    │     │      │    │
│  │  │                   └────────┬────────┘     │      │    │
│  │  └────────────────────────────│──────────────┘      │    │
│  │                               │                      │    │
│  │  ┌────────────────────────────▼──────────────────┐  │    │
│  │  │              OpenAI TTS API                    │  │    │
│  │  │         POST /v1/audio/speech                  │  │    │
│  │  │         Model: tts-1                           │  │    │
│  │  └───────────────────┬────────────────────────────┘  │    │
│  │                      │                               │    │
│  │  ┌───────────────────▼────────────────────────────┐  │    │
│  │  │         Audio Player (Mutex Protected)          │  │    │
│  │  │   macOS: afplay │ Linux: mpv │ Win: PowerShell  │  │    │
│  │  └─────────────────────────────────────────────────┘  │    │
│  └──────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘

Usage

speak(text, voice)

Convert text to speech and play it aloud.

Parameters:

Parameter	Type	Required	Description
`text`	string	Yes	Text to speak (max 4096 chars)
`voice`	string	No	Voice to use (default: alloy)

Available Voices:

Voice	Description
`alloy`	Neutral, balanced
`echo`	Male, warm
`fable`	British accent
`onyx`	Deep male
`nova`	Female, friendly
`shimmer`	Soft female

Example:

Code

Use the speak tool to say "Build completed successfully!" with the nova voice.

tts_status()

Get the current status of the TTS system.

Returns:

config.json

{
  "worker_count": 2,
  "queue_size": 50,
  "queue_pending": 0,
  "total_processed": 15,
  "total_failed": 0,
  "is_playing": false,
  "recent_jobs": [...]
}

Automatic TTS (Deterministic)

This plugin includes a Stop hook that automatically speaks the first sentence of every Claude response. No configuration needed - it just works.

How it works:

Code

Claude responds → Stop hook fires → First sentence extracted → Audio plays

The hook runs in the background and won't block Claude's responses.

speak-text CLI

A standalone binary for direct TTS without going through MCP:

bash

# Basic usage
speak-text "Hello world"

# With voice selection
speak-text -voice onyx "Error occurred"

Located at ~/.claude/plugins/claude-code-tts/bin/speak-text after installation.

Project Structure

Code

claude-code-tts/
├── cmd/
│   ├── tts-server/
│   │   └── main.go           # MCP server entry point
│   └── speak-text/
│       └── main.go           # Standalone CLI binary
├── hooks/
│   └── auto-speak.sh         # Stop hook for deterministic TTS
├── internal/
│   ├── audio/
│   │   └── player.go         # Cross-platform audio playback
│   ├── server/
│   │   ├── server.go         # MCP server & tool handlers
│   │   └── worker.go         # Worker pool implementation
│   └── tts/
│       └── openai.go         # OpenAI TTS client
├── plugin.json                # Plugin metadata + hook config
├── Makefile                   # Build automation
└── install.sh                 # One-liner installer

Building from Source

bash

# Clone the repository
git clone https://github.com/ybouhjira/claude-code-tts.git
cd claude-code-tts

# Build
make build

# Install to Claude Code plugins
make install

# Run tests
make test

Troubleshooting

"OPENAI_API_KEY environment variable is required"

Set your OpenAI API key:

server.ts

export OPENAI_API_KEY="sk-..."

"No suitable audio player found on Linux"

Install one of: mpv, ffplay, or mpg123:

bash

# Ubuntu/Debian
sudo apt install mpv

# Fedora
sudo dnf install mpv

# Arch
sudo pacman -S mpv

Audio not playing on macOS

Check that afplay works:

bash

# Test with a sample audio file
afplay /System/Library/Sounds/Ping.aiff

Queue is full

The default queue size is 50. If you're hitting this limit:

Wait for current jobs to complete
Check tts_status() to see pending jobs
The queue will drain as jobs are processed

High latency

OpenAI TTS API typically takes 1-3 seconds per request
Audio files must download completely before playing
Consider keeping messages short for faster feedback

API Costs

This plugin uses OpenAI's tts-1 model:

Cost: ~$0.015 per 1,000 characters
Example: "Hello, world!" (13 chars) = ~$0.0002

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Credits

OpenAI TTS API
mcp-go - Go MCP implementation
Model Context Protocol

Read the full README →View source on GitHub →

Related MCP Servers

View all in Text-to-Speech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

7mo ago

Most recent push to the default branch.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Claude Code Tts

Six voices: alloy (neutral), echo (male warm), fable (British accent), onyx (deep male), nova (female friendly), shimmer (soft female).

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ybouhjira-claude-code-tts?style=directory)](https://allmcps.com/mcp/ybouhjira-claude-code-tts)

HTML Embed

<a href="https://allmcps.com/mcp/ybouhjira-claude-code-tts"><img src="https://allmcps.com/api/badge/ybouhjira-claude-code-tts?style=directory" alt="Claude Code Tts on AllMCPs" /></a>

Technical Specs & Signals

CategoryText-to-Speech

PricingBring your own API key (usage-based cost)

9/10 checks healthy over the last 32d

43Quality signal: Fair · 43/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools19/30

Adoption & activity3/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🎧 Text-to-Speech →Alternatives to Claude Code Tts →Install in Claude Desktop Install in Cursor Install in VS Code