mcp-speak-when-done

An MCP server that makes AI agents speak a brief summary of every response out loud.

When installed, the agent sees a speak_when_done tool with instructions to call it at the end of every response with a 1-3 sentence spoken summary.

Install

uvx mcp-speak-when-done

Claude Desktop / Claude Code

Add to your MCP configuration:

{
  "mcpServers": {
    "speak-when-done": {
      "command": "uvx",
      "args": ["mcp-speak-when-done"],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

Works with any OpenAI-compatible TTS API. The provider is auto-detected from your API key:

Requirements

One audio player must be installed: ffplay (from ffmpeg), mplayer, or vlc.

Configuration

All settings are optional environment variables:

Remote Use (SSH + SSE)

If you run Claude on a remote server but want audio on your local machine:

1. On your local machine (has speakers + API key):

OPENAI_API_KEY="your-key" mcp-speak-when-done --transport sse

This starts an SSE server on port 8000 (override with FASTMCP_PORT).

2. SSH tunnel from the remote server to your local machine:

ssh -R 8000:localhost:8000 remote-server

3. On the remote server, configure Claude with proxy mode:

{
  "mcpServers": {
    "speak-when-done": {
      "command": "uvx",
      "args": ["mcp-speak-when-done"],
      "env": {
        "SPEECH_PROXY_URL": "http://localhost:8000/sse"
      }
    }
  }
}

No API key needed on the remote side. If your local machine is off, the tool silently returns success — Claude keeps working normally.

License

GPL-3.0-or-later