transcript-tts

A minimal MCP server that converts text/transcripts into MP3 audio using Microsoft Edge's free neural text-to-speech voices (edge-tts). No API key, no account, no usage cap — it's an unofficial use of the same TTS service behind Edge's "Read Aloud" feature.

Tools

• text_to_speech(text, voice="en-US-AriaNeural", rate="+0%", volume="+0%", pitch="+0Hz", filename=None) Synthesizes text to an MP3 file. Returns {"audio_path": ..., "voice": ...}. Files are saved to ~/tts-output/ by default (override with TRANSCRIPT_TTS_OUTPUT_DIR).

• list_voices(locale_prefix=None) Lists available voices, optionally filtered by locale (e.g. "en-US", "ja", "en-GB").

Related MCP server: Edge TTS MCP

Setup

Requires uv.

git clone https://github.com/ShevinuM/transcript-tts.git
cd transcript-tts
uv sync

Register with Claude Code:

claude mcp add --scope user transcript-tts -- \
  /path/to/transcript-tts/.venv/bin/python /path/to/transcript-tts/server.py

Or add it manually to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "transcript-tts": {
      "command": "/path/to/transcript-tts/.venv/bin/python",
      "args": ["/path/to/transcript-tts/server.py"]
    }
  }
}

Environment variables

• TRANSCRIPT_TTS_OUTPUT_DIR — where MP3s are saved (default: ~/tts-output)

• TRANSCRIPT_TTS_VOICE — default voice short name (default: en-US-AriaNeural)

Notes

Requires mcp[cli]>=2.0.0 — the MCP Python SDK renamed FastMCP to MCPServer in its 2.0 release, so this won't work against older mcp SDK versions without adjusting the import in server.py.