modbender/skill-library-mcp

edge-tts-unlimited

Free, unlimited text-to-speech using Microsoft Edge's neural voices via Python edge-tts.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/modbender/skill-library-mcp --skill edge-tts-unlimited

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Edge TTS Unlimited

Free, unlimited neural TTS. No API key. No credits. No character limits.

Why This Over Other TTS Skills?

ProblemOther skillsThis skill
Long text (>5K chars)Fail or need chunkingWorks natively via --file
CostElevenLabs burns $5/mo in 4 briefsFree forever
API keysRequiredNone needed
Server deploymentSome need native depsPure Python, works on Fly.io/Docker
55-minute audioNot tested/supportedTested and confirmed

Quick Start

Generate speech from text:

bash
scripts/speak.sh "Hello world" -o output.mp3

Generate from file (recommended for long text):

bash
scripts/speak.sh --file /tmp/my-script.txt -o output.mp3

With voice and speed:

bash
scripts/speak.sh --file script.txt -v en-US-GuyNeural -r "+5%" -o brief.mp3

Requirements

  • Python 3.8+ (pre-installed on most systems)
  • uv package manager OR pip — script auto-detects

The script auto-installs edge-tts on first run via uv run --with edge-tts (no venv needed).

Voice Presets

Use --preset for quick voice selection:

PresetVoiceStyle
news-usen-US-GuyNeural +5%Lively US news anchor
news-bbcen-GB-RyanNeuralAuthoritative British
calmen-US-AndrewNeural -10%Warm, relaxed
fasten-US-ChristopherNeural +20%Speed-read
bash
scripts/speak.sh --file brief.txt --preset news-us -o brief.mp3

All Options

scripts/speak.sh [TEXT] [OPTIONS]
  TEXT              Text to speak (or use --file)
  --file, -f FILE   Read text from file (recommended for long content)
  --voice, -v NAME  Voice name (default: en-US-GuyNeural)
  --rate, -r RATE   Speed adjustment: "+5%", "-10%", etc.
  --preset, -p NAME Use a voice preset (see above)
  --output, -o FILE Output path (default: /tmp/tts-{timestamp}.mp3)
  --list            List available voices
  --list-filter STR Filter voice list (e.g. "british", "female")

Popular Voices

Run scripts/speak.sh --list for all voices, or filter:

bash
scripts/speak.sh --list-filter british
scripts/speak.sh --list-filter female

English highlights:

  • en-US-GuyNeural — Male, news/passion (best for briefs)
  • en-US-ChristopherNeural — Male, authoritative
  • en-US-AriaNeural — Female, confident
  • en-GB-RyanNeural — Male, British steady
  • en-GB-SoniaNeural — Female, British

Tested Limits

CharsDurationFile SizeResult
7,400~6 min2.6 MB✅
18,000~21 min7.3 MB✅
46,200~55 min18.8 MB✅

No hard limit found. Microsoft Edge TTS service handles arbitrarily long text.

Tips

  • Always use `--file` for text longer than a sentence — avoids shell quoting issues
  • Rate "+5%" sounds natural for news; "+20%" for speed-listening
  • Edge TTS interprets [short pause] as literal text — use commas and periods for natural pauses
  • Audio is 48kbps mono MP3 by default — good enough for voice, small file size