Voice Status Report MCP Server
Description
# Voice Status Report MCP Server  [](https://badge.fury.io/py/voice-status-report-mcp-s…
About
# Voice Status Report MCP Server  [](https://badge.fury.io/py/voice-status-report-mcp-server) [
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Voice Status Report MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
You need an OpenAI API key. Configure the server by adding a stanza to your claude_desktop_config.json with the command uvx voice-status-report-mcp-server and the environment variable OPENAI_API_KEY. Optional command line arguments include --ding (play a ding before each message), --voice (choose from voices like alloy, ash, coral, echo, fable, onyx, nova, sage, shimmer; default coral), --speed (speech speed 0.5–4.0; default 4.0), and --instructions (custom voice instructions). Example: voice-status-report-mcp-server --ding --voice nova.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"voice status report mcp server": {
"voice-status-report": {
"command": "uvx",
"args": [
"voice-status-report-mcp-server"
],
"env": {
"OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
}
}
}
}
}McpServers
{
"voice-status-report": {
"command": "uvx",
"args": [
"voice-status-report-mcp-server"
],
"env": {
"OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
}
}
}Voice Status Report MCP Server
A Model Context Protocol (MCP) server that provides voice status updates using OpenAI's text-to-speech API. This allows language models to communicate with users through short voice messages: reporting on the progress of a task, or confirming that a command has been executed. It's espesially useful when working with Cursor or Claude code: you can give the agent a task, go on to do something else but keep receiving status reports on agent's progess and when it's done with its task and needs your attention.
This MCP server is meant to be batteries included: the description of the summarize tool (prepended to system message by most MCP clients) asks the model to use this tool to report on the progress of a task.
Available Tools
The server exposes the following tool:
- summarize(text: str): Converts the provided text into speech using OpenAI's TTS API and plays it to the user. This is useful for providing status updates or confirmations after code changes or commands.
Usage
You'll need an OpenAI API key to use this server.
Claude for Desktop
Update your claude_desktop_config.json (located in ~/Library/Application\ Support/Claude/claude_desktop_config.json on macOS and %APPDATA%/Claude/claude_desktop_config.json on Windows) to include the following:
{
"mcpServers": {
"voice-status-report": {
"command": "uvx",
"args": [
"voice-status-report-mcp-server"
],
"env": {
"OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
}
}
}
}
Command Line Options
The server accepts the following command line options:
- --ding: Enable the ding sound that plays before each voice message. By default, the ding sound is disabled.
- --voice [VOICE]: Choose the voice for speech generation. Available options: alloy, ash, coral (default), echo, fable, onyx, nova, sage, shimmer.
- --speed SPEED: Set the speech speed (0.5-4.0, where higher is faster). Default is 4.0.
- --instructions TEXT: Provide custom voice instructions for the TTS model. By default, the server uses a preset instruction for a calm, friendly voice.
Examples
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
