speak
Makes a WAV voice message with Piper.
Text is cut to 2,000 characters. Times out after 60 seconds.
- Tool name
- speak
- Group
- Voice
- Risk
- low
- Needs approval
- never
- Approval rule
- No approval.
- Allowed in scheduled jobs
- No
- Default
- off
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| text | string | Yes | Text to type or say. |
Returns
A status line and an audio file.
Example (made up for this page)
{
"text": "demo"
}Spoke it using 'en_US-lessac-medium'.Side effects
- Writes a WAV file and queues it for sending.
How it can fail
| When | What the agent sees |
|---|---|
| No voice chosen | No voice picked yet. |
| Piper missing | The piper command isn't installed |
| Timeout | Speech synthesis timed out. |
See also:Voice tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.