mcpField
Z
Zonos MCP Integration

Zonos MCP Integration

Local
github.com/PhialsBasementMedia & Design14Updated 77w ago
Repository

About Zonos MCP Integration

Zonos MCP Integration connects to Zonos TTS so Claude can generate speech from text. It offers language and emotion options and plays audio through PulseAudio.

Key features

  1. 01Text-to-speech
  2. 02Multiple emotion options
  3. 03Multiple language support
  4. 04Audio playback through PulseAudio

Use cases

  1. 01Have Claude turn replies into speech
  2. 02Choose a language and emotion for generated speech
  3. 03Play generated speech through PulseAudio

MCP support

The MCP server exposes the `speak_response` tool to Claude for converting text to speech with Zonos TTS. It requires a running Zonos API and configured PulseAudio.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "Zonos-TTS-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MseeP.ai Security Assessment Badge

Zonos MCP Integration

smithery badge

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

  1. Make sure you have Zonos running with our API implementation (PhialsBasement/zonos-api)

  2. Install dependencies:

npm install @modelcontextprotocol/sdk axios
  1. 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
  1. Build the MCP server:
npm run build
# This will create the dist folder with the compiled server
  1. 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.