TalkiTo MCP server
2026년 8월 18일 커밋개발자가 Claude Code, Codex 및 기타 AI agent와 음성으로 대화하고, Slack, WhatsApp 또는 SMS로 음성 답변을 받을 수 있게 합니다.
다른 이름 robdmac/talkito
- 스타
- 54
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 8월 18일
- 라이선스
- AGPL-3.0
TalkiTo MCP란?
개발자가 Claude Code, Codex 및 기타 AI agent와 음성으로 대화하고, Slack, WhatsApp 또는 SMS로 음성 답변을 받을 수 있게 합니다.
프로젝트 README에서 생성된 요약
TalkiTo MCP server 정보
TalkiTo는 개발자가 음성 및 메시징 플랫폼을 통해 AI agent와 상호작용할 수 있도록 지원합니다. 이 도구를 사용하면 Claude Code 및 OpenAI Codex와 직접 대화하고 음성 응답을 받을 수 있습니다. CLI 도구, Python 라이브러리 또는 웹 확장 프로그램으로 작동하며, mcp-sse-server 명령어를 사용하여 MCP server로 실행할 수 있습니다.
사용자는 다양한 text-to-speech 및 speech-to-text 제공업체 중에서 선택하여 환경을 맞춤 설정할 수 있습니다. OpenAI, AWS Polly, Azure, Google Cloud, ElevenLabs와 같은 클라우드 기반 서비스부터 Kokoro, Piper, 로컬 Whisper와 같은 로컬 오프라인 엔진까지 다양한 옵션을 제공합니다. 원격 업데이트의 경우, 환경 설정에 따라 서버가 Slack 채널, WhatsApp 수신자 또는 Twilio SMS를 통해 알림을 보낼 수 있습니다.
활용 사례
- 1웹 기반 AI 출력브라우저 확장을 통해 bolt.new 또는 v0.dev와 같은 웹 agent로부터 음성 출력을 받습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
AZURE_SPEECH_KEYWHISPER_MODEL
| 이름 | 설명 | 유형 |
|---|---|---|
| AZURE_SPEECH_KEY | — | |
| WHISPER_MODEL | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능robdmac/talkito is public and reachablegithub.com/robdmac/talkito ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-08-18github.com/robdmac/talkito ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기TalkiTo
TalkiTo lets developers talk, slack and whatsapp with Claude Code and OpenAI Codex. It can be used as a command-line tool, a web extension, and as a Python library.
🚀 Quick Install
Option 1: One-liner Install Script (Recommended)
curl -sSL https://raw.githubusercontent.com/robdmac/talkito/main/install.sh | bash
Option 2: PyPI
pip install talkito
Then just run:
talkito claude
Install for End Users
From Source (Stable)
# Clone the repository
git clone https://github.com/robdmac/talkito.git
cd talkito
# Create and activate virtual environment (recommended)
python3 -m venv venv
source venv/bin/activate
# Install system dependencies (macOS)
brew install portaudio
# Install package (normal install - gets updates via git pull)
pip install .
# Run this in a directory you want to use claude with
talkito claude
Install for Developers
Editable Install (Development)
# Clone the repository
git clone https://github.com/robdmac/talkito.git
cd talkito
# Create and activate virtual environment (recommended)
python3 -m venv venv
source venv/bin/activate
# Install system dependencies (macOS)
brew install portaudio
# Install in development mode (editable install)
pip install -e .
# Run this in a directory you want to use claude with
talkito claude
or for the web extension run as
talkito --mcp-sse-server
then go to chrome://extensions/ and load unpacked the extensions/chrome/ dir
Demo Video
AI Assistant Compatibility
| AI Assistant | Method | Status |
|---|---|---|
| Claude Code | Terminal | Fully Supported |
| Codex Cli | Terminal | Fully Supported |
| bolt.new | Web Extension | Output Only |
| v0.dev | Web Extension | Output Only |
| replit.com | Web Extension | Output Only |
| Other agents | Terminal | In Progress |
Run with Claude Code
run talkito claude
Run with Codex Cli
run talkito codex
Run as an MCP server
run talkito --mcp-server
Run the TalkiTo configuration menu
run talkito
Advanced Options
# Disable auto-skip to newer content (auto-skip is on by default)
talkito --dont-auto-skip-tts claude
# Use different TTS providers
talkito --tts-provider polly --tts-voice Matthew --tts-region us-west-2 echo "Hello with AWS"
talkito --tts-provider azure --tts-voice en-US-JennyNeural echo "Hello with Azure"
talkito --tts-provider gcloud --tts-voice en-US-Journey-F echo "Hello with Google"
talkito --tts-provider kittentts --tts-voice expr-voice-3-f echo "Hello with KittenTTS"
talkito --tts-provider kokoro --tts-voice af_heart echo "Hello with Kokoro (local)"
talkito --tts-provider piper --tts-voice en_US-lessac-medium echo "Hello with Piper (local)"
talkito --tts-provider neutts2e echo "Hello with NeuTTS (local)"
# Use different ASR providers
talkito --asr-provider gcloud --asr-language en-US claude
AZURE_SPEECH_KEY=... AZURE_SPEECH_REGION=eastus talkito --asr-provider azure claude
WHISPER_MODEL=small WHISPER_COMPUTE_TYPE=int8 talkito --asr-provider local_whisper claude
talkito --asr-language es-ES echo "Hola mundo" # Spanish recognition
# Enable remote communication (configure via environment variables)
talkito --slack-channel '#alerts' python manage.py runserver
talkito --whatsapp-recipients +1234567890 long-running-command
talkito --sms-recipients +1234567890,+0987654321 server-monitor.sh
Using tts.py (Standalone TTS)
The TTS module can be used independently for text-to-speech operations:
#!/usr/bin/env python3
import tts
# Initialize TTS
engine = tts.detect_tts_engine()
tts.start_tts_worker(engine)
# Speak text
tts.queue_for_speech("Hello from the TTS module!")
# Wait and cleanup
import time
time.sleep(2)
tts.shutdown_tts()
Using asr.py (Standalone ASR)
The ASR module can be used independently for speech recognition:
#!/usr/bin/env python3
import asr
# Define callback for recognized text
def handle_text(text):
print(f"You said: {text}")
# Start dictation
asr.start_dictation(handle_text)
# Keep running (press Ctrl+C to stop)
try:
import time
while True:
time.sleep(1)
except KeyboardInterrupt:
asr.stop_dictation()
Provider Configuration
Text-to-Speech (TTS) Providers
System TTS (Default)
- macOS: Uses built-in
saycommand - Linux: Uses
espeak,festival, orflite(install via package manager) - Setup: No API key needed
OpenAI TTS
- Get API Key: https://platform.openai.com/api-keys
- Voices: alloy, echo, fable, onyx, nova, shimmer
- Usage:
--tts-provider openai --tts-voice nova
AWS Polly
- Get Credentials: https://aws.amazon.com/polly/getting-started/
- Setup: Set
AWS_ACCESS_KEY_IDandAWS_SECRET_ACCESS_KEY - Voices: Joanna, Matthew, Amy, Brian, and more
- Usage:
--tts-provider polly --tts-voice Matthew
Azure Speech Services
- Get API Key: https://azure.microsoft.com/en-us/services/cognitive-services/speech-services/
- Setup: Set
AZURE_SPEECH_KEYandAZURE_REGION - Voices: en-US-JennyNeural, en-US-AriaNeural, and many more
- Usage:
--tts-provider azure --tts-voice en-US-JennyNeural
Google Cloud Text-to-Speech
- Get Credentials: https://cloud.google.com/text-to-speech/docs/quickstart
- Setup: Set
GOOGLE_APPLICATION_CREDENTIALSto service account JSON path - Voices: en-US-Journey-F, en-US-News-N, and more
- Usage:
--tts-provider gcloud --tts-voice en-US-Journey-F
ElevenLabs
- Get API Key: https://elevenlabs.io/
- Setup: Set
ELEVENLABS_API_KEY - Voices: Various voice IDs available
- Usage: Configure in code or .env file
Deepgram
- Get API Key: https://deepgram.com/
- Setup: Set
DEEPGRAM_API_KEY - Voices: aura-asteria-en, aura-luna-en, aura-stella-en, and more
- Usage:
--tts-provider deepgram --tts-voice aura-asteria-en
KittenTTS (Local / Offline)
- Install:
pip install https://github.com/KittenML/KittenTTS/releases/download/0.1/kittentts-0.1.0-py3-none-any.whl soundfile phonemizer - Setup: No API key required. First run prompts to download the selected model (default
kitten-tts-nano-0.2) into the Hugging Face cache. ConfigureKITTENTTS_MODELandKITTENTTS_VOICEto pick different quality/voice options. - Best for: Ultra-lightweight CPU-only voices that stay on-device.
- Usage:
KITTENTTS_MODEL=kitten-tts-nano-0.2 talkito --tts-provider kittentts --tts-voice expr-voice-3-f
Kokoro (Local / Offline)
- Install:
pip install 'kokoro>=0.9.4' soundfile phonemizer - Setup: No API key required. TalkiTo will download Kokoro weights the first time you run it (set
KOKORO_LANGUAGE,KOKORO_VOICE,KOKORO_SPEEDto control defaults). - Best for: High-quality multilingual voices without sending audio to a cloud provider.
- Usage:
talkito --tts-provider kokoro --tts-voice af_heart --tts-language en-US
Piper (Local / Offline)
- Install:
pip install piper-tts - Setup: No API key required. A voice is a single ONNX file of a few tens of megabytes, downloaded on first use into
~/.cache/talkito/piper(setPIPER_VOICEandPIPER_VOICE_DIRto change the default voice or location). - Best for: The lightest offline option by a wide margin, and the fastest. It needs no torch at all, where the other local engines pull in hundreds of megabytes of runtime.
- Voices:
en_US-lessac-medium(default),en_GB-alan-medium,en_US-amy-mediumand many more — the menu lists a shortlist, but any name Piper publishes is accepted. Full list:python -m piper.download_voices --help - Usage:
talkito --tts-provider piper --tts-voice en_GB-alan-medium
NeuTTS 2E (Local / Offline)
- Install:
pip install neutts llama-cpp-python soundfile - Setup: No API key required. The first run downloads a quantized backbone and a decoder-only ONNX codec, around 600 MB together. Set
NEUTTS2E_VOICEandNEUTTS2E_EMOTIONto change the speaker and delivery. - Best for: Expressive, emotion-conditioned speech that stays on-device. It is a language model over a neural audio codec rather than a feed-forward synthesiser, so it sounds markedly less robotic than its size suggests.
- Speakers:
emily(default),paul,sophie,steven. Emotions:neutral,happy,sad,angry,surprised,fearful,disgusted. - Devices: On Apple Silicon the backbone runs on Metal automatically and falls back to CPU if unavailable.
NEUTTS_DEVICE=cpupins everything to CPU;NEUTTS_BACKBONE_DEVICEoverrides the backbone alone. - Usage:
NEUTTS2E_EMOTION=happy talkito --tts-provider neutts2e --tts-voice sophie
Automatic Speech Recognition (ASR) Providers
Google Speech Recognition (Default)
- Free: No API key required
- Limitations: Best for short utterances, requires internet
- Usage: Default when no provider specified
Google Cloud Speech-to-Text
- Get Credentials: https://cloud.google.com/speech-to-text/docs/quickstart
- Setup: Set
GOOGLE_APPLICATION_CREDENTIALS - Features: Better accuracy, streaming support
- Usage:
--asr-provider gcloud
AssemblyAI
- Get API Key: https://www.assemblyai.com/
- Setup: Set
ASSEMBLYAI_API_KEY - Features: Real-time transcription, speaker detection
- Usage: Configure in code or .env file
Deepgram
- Get API Key: https://deepgram.com/
- Setup: Set
DEEPGRAM_API_KEY - Features: Fast, accurate real-time transcription
- Usage: Configure in code or .env file
Houndify
- Get Credentials: https://www.houndify.com/
- Setup: Set
HOUNDIFY_CLIENT_IDandHOUNDIFY_CLIENT_KEY - Features: Natural language understanding
- Usage:
--asr-provider houndify
AWS Transcribe
- Get Credentials: https://aws.amazon.com/transcribe/
- Setup: Set AWS credentials
- Features: Streaming transcription
- Usage:
--asr-provider aws --aws-region us-west-2
Azure Speech Services
- Get API Key: https://azure.microsoft.com/en-us/services/cognitive-services/speech-services/
- Setup: Set
AZURE_SPEECH_KEYandAZURE_SPEECH_REGION, thenpip install azure-cognitiveservices-speech - Features: Low-latency streaming dictation with automatic punctuation
- Usage:
AZURE_SPEECH_KEY=... AZURE_SPEECH_REGION=eastus talkito --asr-provider azure
Local Whisper (On-Device)
- Install:
pip install faster-whisper(default) orWHISPER_COREML=1 pip install pywhispercppfor Apple Silicon/CoreML acceleration - Setup: No API key required. Configure
WHISPER_MODEL(e.g.,small,medium),WHISPER_DEVICE(cpu,cuda, ormps), andWHISPER_COMPUTE_TYPE(int8,int8_float16, etc.). Models are cached locally and TalkiTo will prompt before downloading unlessTALKITO_AUTO_APPROVE_DOWNLOADS=1. - Usage:
WHISPER_MODEL=small WHISPER_COMPUTE_TYPE=int8 talkito --asr-provider local_whisper
Communication Providers (Remote Interaction)
Twilio SMS
- Get Account: https://www.twilio.com/try-twilio
- Setup: Set
TWILIO_ACCOUNT_SID,TWILIO_AUTH_TOKEN,TWILIO_PHONE_NUMBERyou will need to a verified number to avoid being filtered. - Features: Send command output via SMS, receive input via SMS
- Usage:
--sms-recipients +1234567890
Twilio WhatsApp
- Get Started: https://www.twilio.com/whatsapp
- Setup Instructions: Run
talkito --setup-whatsappfor detailed setup guide - Required Environment Variables:
TWILIO_ACCOUNT_SID: Your Twilio account SIDTWILIO_AUTH_TOKEN: Your Twilio auth tokenTWILIO_WHATSAPP_NUMBER: Twilio's WhatsApp number (usually +14155238886)WHATSAPP_RECIPIENTS: Your WhatsApp numberZROK_RESERVED_TOKEN: Your zrok reserved share token
- Quick Setup:
- Join Twilio WhatsApp Sandbox at https://www.twilio.com/console/sms/whatsapp/sandbox
- Send the join code via WhatsApp to +1 415 523 8886
- Install zrok and create a reserved share:
zrok reserve public http://localhost:8080 - Set webhook URL in Twilio Console to:
https://YOUR-TOKEN.share.zrok.io/whatsapp
- Usage:
--whatsapp-recipients +1234567890
Slack
- Create App: https://api.slack.com/apps
- Setup: Set
SLACK_BOT_TOKENand optionallySLACK_APP_TOKEN - Features: Send output to channels, receive commands
- Usage:
--slack-channel '#channel-name'
Environment Configuration
Talkito supports two environment files:
.env- Primary configuration (takes precedence).talkito.env- Secondary configuration (won't override.env)
Copy .env.example to .env and add your API keys:
cp .env.example .env
# Edit .env with your API keys
For WhatsApp setup with zrok tunneling:
ZROK_RESERVED_TOKEN: Your zrok reserved share token for webhook tunneling
Requirements
- Python 3.10+
- macOS (with
saycommand) or Linux (withespeak,festival, orflite) - Optional:
SpeechRecognitionandpyaudiofor ASR support - Optional: Provider-specific Python packages (installed as needed)
Contributing
See CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
License
This project is licensed under the GNU Affero General Public License v3.0 or later - see the LICENSE file for details.
Copyright (C) 2025 Robert Macrae
TalkiTo MCP 질문
Claude Code에서 TalkiTo를 어떻게 실행하나요?
패키지를 설치한 후 Claude Code를 사용하려는 디렉토리에서 'talkito claude'를 실행합니다.
TalkiTo를 MCP server로 실행할 수 있나요?
네, 'talkito --mcp-server'를 실행하면 MCP server로 시작되며, '--mcp-sse-server'는 웹 확장을 제공합니다.
API 키 없이도 TalkiTo를 사용할 수 있나요?
네, 기본 시스템 TTS와 기본 Google 음성 인식은 API 키가 필요하지 않으며, Piper 및 Kokoro와 같은 로컬 엔진은 오프라인으로 작동합니다.
TalkiTo가 지원하는 text-to-speech 제공업체는 무엇인가요?
기본 시스템 TTS 외에도 OpenAI, AWS Polly, Azure, Google Cloud, ElevenLabs, Deepgram 및 로컬 엔진인 KittenTTS, Kokoro, Piper, NeuTTS를 지원합니다.
TalkiTo가 Slack이나 WhatsApp으로 업데이트를 보낼 수 있나요?
네, 명령어를 실행할 때 --slack-channel 또는 --whatsapp-recipients와 같은 플래그를 사용하여 원격 통신을 활성화할 수 있습니다.
