About TTS MCP
TTS MCP is a server for IDEs and other MCP hosts that turns LLM text into speech and plays it through the host’s speakers. It combines configured remote and local providers, with voice routing and local caching.
Key features
- 01Playback through host speakers
- 02Tools for configured TTS providers
- 03Voice and provider persona routing
- 04Local audio artifact caching
Use cases
- 01Hear LLM text read aloud in an IDE
- 02Choose a configured voice by persona
- 03Reuse locally cached audio
MCP support
It exposes text-to-speech provider tools to MCP clients, which can send text for synthesis and playback.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMETTS 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="<YOUR_API_KEY_HERE>"
ELEVENLABS_API_KEY="<YOUR_API_KEY_HERE>"
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
Comments
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.