Voice Status

Provides voice status updates via OpenAI TTS, enabling spoken task progress and confirmations.

python

8

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tomekkorbak-voice-status-report-mcp-server": {
      "command": "uvx",
      "args": [
        "voice-status-report-mcp-server"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

This MCP server provides voice status updates by converting text reports into spoken audio using OpenAI's text-to-speech capabilities. You can use it to receive real-time progress updates or confirmations from language models as you run tasks, making interactions feel more natural and hands-free.

How to use

Connect this MCP server to your preferred MCP client to start receiving spoken status updates. You can trigger a status report by issuing task-related messages to the agent, and the server will respond with short voice messages that describe progress, milestones, and completions. Use the summarize tool to convert task notes or logs into speech so you can hear progress while you focus on other work.

How to install

Prerequisites you need to prepare before running the server are:
- An OpenAI API key for the text-to-speech process
- The MCP runtime you will use to run the server (uvx in this example)
- A workstation with Python installed if you plan to verify Python availability (the project references Python 3.12).

Install and run the MCP server using the following command block. This starts the MCP server and enables voice reporting with default settings. You can customize the options after the command as needed.

uvx voice-status-report-mcp-server

# Optional: enable ding sound and customize voice at startup
uvx voice-status-report-mcp-server --ding --voice nova --speed 3.0

Additional notes

Environment variables you need to provide when configuring the client are shown below. Keep your OpenAI API key secure and do not share it publicly. The client should set the key in the environment for the MCP connection.

OpenAI API key placeholder you will supply in your client configuration: OPENAI_API_KEY.

Usage patterns and tips

Use the summarize tool to convert task notes into spoken feedback so you can hear updates without needing to read long text logs. The tool name and purpose are summarize(text: str) which turns text into speech and plays it to you.
You can start with the simplest setup and gradually enable additional options like a specific voice or speech rate to suit your preferences.

Available tools

summarize

Converts provided text into speech using OpenAI's TTS API and plays it to the user for status updates or confirmations.