Voice + calendar tools
Speech tools and Google Calendar integration.
#Voice (TTS / STT)
tota supports multiple TTS and STT providers. Configure the default with tota setup voice.
TTS providers — set voice.ttsProvider in tota.yaml or the provider param per call:
| Provider | Key required | Notes |
|---|---|---|
openai (default) | OPENAI_API_KEY | TTS-1 model, 6 voices |
elevenlabs | ELEVENLABS_API_KEY | eleven_multilingual_v2 model |
google | GOOGLE_TTS_API_KEY | Cloud TTS, Journey-F voice |
STT providers — set voice.sttProvider in tota.yaml or the provider param per call:
| Provider | Key required | Notes |
|---|---|---|
openai (default) | OPENAI_API_KEY | Whisper-1 |
groq | GROQ_API_KEY | Whisper-large-v3, fast inference |
Telegram voice messages are automatically transcribed using whichever STT provider is configured.
| Tool | Description |
|---|---|
text_to_speech | Convert text to speech and save as an MP3. Params: text, voice?, provider? (openai|elevenlabs|google), send? |
transcribe_audio | Transcribe a local audio file. Params: path, language?, provider? (openai|groq) |
Read this aloud using ElevenLabs
> text_to_speech text="Meeting starts in 5 minutes" provider=elevenlabs
Transcribe with Groq (faster)
> transcribe_audio path=/tmp/recording.ogg provider=groq
Supported OpenAI TTS voices: alloy, echo, fable, onyx, nova, shimmer.
Run tota setup voice to configure providers interactively.
#Google Calendar
Requires a Google Cloud OAuth2 app. Set GOOGLE_CALENDAR_CLIENT_ID and GOOGLE_CALENDAR_CLIENT_SECRET (or add them to ~/.tota/tota.yaml under calendar:).
| Tool | Description |
|---|---|
calendar_auth | Manual OAuth2 fallback — only needed in headless environments |
list_events | List upcoming calendar events |
create_event | Create a calendar event |
check_availability | Check free/busy availability for a time range |
delete_event | Delete an event by ID |
First-time setup (one-time, automatic):
- In Google Cloud Console → Credentials → your OAuth Client ID, add this to Authorized redirect URIs:
http://localhost:8765/oauth2callback - Run
tota setup calendarand enter your Client ID and Secret. - The first time you use a calendar tool, tota opens your browser automatically → click Allow → done. No code copying.