claude-code-tts-edge

claude-code-tts-edge

Auto text-to-speech plugin for Claude Code. Converts short responses to voice and sends them as Telegram voice messages — 100% free, no API key required.

Uses Microsoft Edge TTS (edge-tts) with 300+ voices in 50+ languages.

How it works

• Short responses (< 300 chars) → sent as voice message to Telegram
• Long responses → text only
• Runs as a Stop hook after each response

Requirements

• Python 3 + edge-tts (pip3 install edge-tts)
• A Telegram bot token (create one with @BotFather)
• Your Telegram chat ID

Installation

# 1. Install edge-tts
pip3 install edge-tts

# 2. Set credentials in your shell profile
export TELEGRAM_BOT_TOKEN="your-bot-token"
export TELEGRAM_CHAT_ID="your-chat-id"

# 3. Install plugin
claude plugin marketplace add https://github.com/devlux-creator/claude-code-tts-edge
claude plugin install claude-code-tts-edge

Configuration

All settings via environment variables:

Variable	Default	Description
TELEGRAM_BOT_TOKEN	(required)	Your Telegram bot token
TELEGRAM_CHAT_ID	(required)	Your Telegram chat ID
TTS_VOICE	es-ES-AlvaroNeural	Edge TTS voice
TTS_MAX_CHARS	300	Max chars to trigger audio

Browse available voices:

edge-tts --list-voices

Popular voices

Language	Voice
Spanish (Spain)	es-ES-AlvaroNeural
Spanish (Mexico)	es-MX-JorgeNeural
English (US)	en-US-GuyNeural
English (UK)	en-GB-RyanNeural
French	fr-FR-HenriNeural

License

MIT