TTS MCP

MCP server that provides Text-to-Speech capabilities. It accepts text output from LLMs, synthesizes it using remote or local audio providers, and plays it directly through the host system's native speakers.

Features

• Direct Playback: Pipes synthesized audio to the host system natively.
• Provider Aggregation: Automatically exposes individual command tools for any configured TTS provider.
• Persona Routing: Map specific voices and providers to semantic names to simplify LLM tool calls.
• Caching: Saves generated audio artifacts locally to an XDG cache directory.

Supported Providers

• FishAudio
• ElevenLabs
• Neets AI
• PlayHT
• Cartesia
• OpenAI
• Azure
• Local APIs

Installation

> Requires Go 1.22+ to build from source via `just init`

Download the pre-compiled binaries matching your OS from the Releases page.

Configuration

`tts-mcp` requires an `.env` file in your standard OS configuration directory:

• Windows: `%APPDATA%\tts-mcp\.env`
• Linux: `~/.config/tts-mcp/.env`
• macOS: `~/Library/Application Support/tts-mcp/.env`

Run the included `tts-mcp-config` CLI to safely initialize this file, or populate it manually:

FISHAUDIO_API_KEY=""
ELEVENLABS_API_KEY=""

Setup

You can attach the server as a standard command-line MCP tool in your preferred AI editor.

Antigravity and Cursor

Add the executable to your MCP Servers configuration list:

• Name: `tts-mcp`
• Type: `command`
• Command: `/absolute/path/to/extracted/tts-mcp`

Claude Code and Claude Desktop

Append to your `claude_desktop_config.json`:

{
  "mcpServers": {
    "tts-mcp": {
      "command": "/absolute/path/to/extracted/tts-mcp"
    }
  }
}

License

MIT