Zonos-TTS MCP Server

Use This MCP server To

Convert Claude's text responses into natural speech output Enable voice interaction for Claude-based chatbots or assistants Integrate speech synthesis into AI workflows using Claude Provide accessibility features by reading text aloud from Claude Automate audio generation for notifications or alerts from Claude Test and develop voice-enabled AI applications with Claude Streamline TTS deployment in multi-model AI environments

README

Zonos MCP Integration

A Model Context Protocol integration for Zonos TTS, allowing Claude to generate speech directly.

Setup

Installing via Smithery

To install Zonos TTS Integration for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @PhialsBasement/zonos-tts-mcp --client claude

Manual installation

Make sure you have Zonos running with our API implementation (PhialsBasement/zonos-api)
Install dependencies:

npm install @modelcontextprotocol/sdk axios

Configure PulseAudio access:

# Your pulse audio should be properly configured for audio playback
# The MCP server will automatically try to connect to your pulse server

Build the MCP server:

npm run build
# This will create the dist folder with the compiled server

Add to Claude's config file: Edit your Claude config file (usually in ~/.config/claude/config.json) and add this to the mcpServers section:

"zonos-tts": {
  "command": "node",
  "args": [
    "/path/to/your/zonos-mcp/dist/server.js"
  ]
}

Replace /path/to/your/zonos-mcp with the actual path where you installed the MCP server.

Using with Claude

Once configured, Claude automatically knows how to use the speak_response tool:

speak_response(
    text="Your text here",
    language="en-us",  # optional, defaults to en-us
    emotion="happy"    # optional: "neutral", "happy", "sad", "angry"
)

Features

Text-to-speech through Claude
Multiple emotions support
Multi-language support
Proper audio playback through PulseAudio

Requirements

Node.js
PulseAudio setup
Running instance of Zonos API (PhialsBasement/zonos-api)
Working audio output device

Notes

Make sure both the Zonos API server and this MCP server are running
Audio playback requires proper PulseAudio configuration

Zonos-TTS-MCP FAQ

How do I install Zonos-TTS-MCP with Claude?

Use Smithery CLI with 'npx -y @smithery/cli install @PhialsBasement/zonos-tts-mcp --client claude' or follow manual setup instructions.

What dependencies are required for Zonos-TTS-MCP?

You need '@modelcontextprotocol/sdk' and 'axios' installed via npm.

Do I need to run the Zonos API separately?

Yes, Zonos-TTS-MCP requires the Zonos API server running to handle TTS requests.

How is audio output handled?

The server uses PulseAudio for audio playback, so proper PulseAudio configuration is necessary.

Can Zonos-TTS-MCP work with other LLMs besides Claude?

While designed for Claude, it can potentially integrate with other LLMs supporting MCP, like OpenAI GPT-4 or Anthropic Claude.

Is the integration secure?

The project includes a security assessment badge from MseeP.ai, indicating attention to security best practices.

Can I customize the voice or speech parameters?

Customization depends on the underlying Zonos TTS API capabilities; check Zonos API docs for options.

What platforms does Zonos-TTS-MCP support?

It primarily targets Linux environments with PulseAudio but may work on other platforms with compatible audio setups.