Voice Summary MCP server

MCP Voice Summary Server

A local MCP server that reads out loud a summary of the actions an AI assistant just performed on your code. Built as an accessibility layer: you hear what the agent did without having to read the full response.

Speaks in the user's language automatically, with female and male voices, and works fully offline if you want it to.

<!-- mcp-name: io.github.eduplopez/mcp-voice-summary -->

Quick start

pip install mcp-voice-summary

Then point your MCP client at the installed command. For Claude Desktop, Cursor or Cline, in claudedesktopconfig.json:

{
  "mcpServers": {
    "voice-summary": {
      "command": "mcp-voice-summary",
      "env": {
        "VOICE_ENGINE": "edge",
        "VOICE_LANGUAGE": "es",
        "VOICE_GENDER": "male"
      }
    }
  }
}

No env block is needed at all: the server picks the voice from your system language. The values above only pin it.

With uvx, without installing anything:

{
  "mcpServers": {
    "voice-summary": {
      "command": "uvx",
      "args": ["mcp-voice-summary"],
      "env": { "VOICE_ENGINE": "edge" }
    }
  }
}

This server is also listed in the MCP Registry under io.github.eduplopez/mcp-voice-summary. The registry metadata lives in server.json in this repo.

Then tell your assistant to use it, for example: "After you finish a task, read a short summary out loud."

Platform support

The edge engine needs an internet connection on every utterance, because the audio is generated by Microsoft's servers. The sapi5 engine is fully offline.

On Linux the audio player is detected automatically; install ffmpeg (which provides ffplay) or mpg123 if nothing is found.

Higher quality Windows voices, offline

Windows ships better voices than the three exposed by default, but hides them under a registry key SAPI5 does not read. Run this once as administrator:

powershell -Command "Start-Process powershell -Verb RunAs -ArgumentList '-ExecutionPolicy Bypass -File .\register_voices_onecore.ps1'"

Afterwards Microsoft Laura and Microsoft Pablo become available to sapi5.

What it does

Exposes an MCP tool, speak_summary, which the assistant calls after modifying code, creating files or running commands.

The summary length is decided by the assistant based on how much work it did: a short sentence for a small change, or a fuller summary when the task was large or had several steps. See Controlling the summary length.

Playback is asynchronous: the tool queues the text and returns immediately, so speaking never blocks the assistant.

Requirements

• Python 3.10 or newer.
• Windows, Linux or macOS.

Shortened. The full README is on GitHub.