Voice Status Report

Voice Status Report

A Model Context Protocol (MCP) server that provides voice status updates using OpenAI's text-to-speech API.

8
Stars
1
Forks
0
Releases

Overview

This MCP server is a Model Context Protocol (MCP) server that provides voice status updates using OpenAI's text-to-speech API. It enables language models to communicate with users through brief audio messages, reporting on the progress of a task or confirming that a command has been executed. It is especially useful when working with Cursor or Claude code: you can assign a task to an agent, step away, and still receive audible progress updates and a notification when the task completes. The server is designed to be batteries included: MCP clients typically prepend the summarize tool to the system message, and this server uses that mechanism to prompt the model to report progress via speech. The available tooling includes the summarize(text: str) function, which converts the provided text into speech using OpenAI's TTS API and plays it back to the user.

Details

Owner
tomekkorbak
Language
Python
License
MIT License
Updated
2025-12-07

Features

Voice status reports via TTS

Converts status messages into spoken audio using OpenAI's TTS API and plays it back to the user.

Summarize tool integration

Includes the summarize tool, used by MCP clients to instruct the model to report progress via speech.

Voice customization

Supports multiple voices: alloy, ash, coral, echo, fable, onyx, nova, sage, shimmer.

Speech speed control

Allows adjusting speech speed via --speed (0.5-4.0; default 4.0).

Custom voice instructions

Accepts custom voice instructions via --instructions to tailor TTS output.

Ding sound option

Optional ding before each voice message via --ding.

Claude/Desktop and Cursor compatibility

Configurable for Claude Desktop and Cursor workflows with example configurations.

OpenAI API key requirement

Requires an OpenAI API key to operate.

Audience

MCP developersIntegrate voice status updates into MCP-enabled tasks and workflows.
Cursor usersReceive spoken progress reports from agents running long tasks.
Claude usersConfigure Claude Desktop to trigger and receive audio status updates from the MCP server.

Tags

MCPvoice statustext-to-speechOpenAITTSCursorClaudestatus updatesvoiceMCP server