MCP.so
Sign In

mcp-say

@blacktop

Repository

About mcp-say

MCP Server for Text to Speech

#golang#text-to-speech#mcp#tts#say#elevenlabs#mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-say": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "https://github.com/blacktop/mcp-tts",
        "--skill",
        "speak"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-say?

mcp-say is an MCP server that adds text-to-speech capabilities to AI assistants like Claude Desktop and Cursor IDE. It provides four tools: say_tts (macOS built-in), elevenlabs_tts, google_tts, and openai_tts, each offering different voices and options.

How to use mcp-say?

Install via go install github.com/blacktop/mcp-tts@latest. Configure in Claude Desktop's claude_desktop_config.json or via command line for Claude Code, Codex CLI, or Gemini CLI. Set required API keys as environment variables. Invoke by calling the appropriate TTS tool (e.g., say_tts, openai_tts) through the MCP protocol.

Key features of mcp-say

  • Four TTS providers: macOS say, ElevenLabs, Google Gemini, OpenAI
  • Sequential (default) or concurrent speech via --sequential-tts flag
  • Save audio to disk with MCP_TTS_OUTPUT_DIR and optional --no-play
  • Suppress "Speaking:" output with MCP_TTS_SUPPRESS_SPEAKING_OUTPUT
  • OpenAI TTS supports speed control (0.25x–4.0x) and custom voice instructions
  • Multi-instance protection prevents overlapping speech across Claude Desktop instances

Use cases of mcp-say

  • Enable an AI assistant to read responses aloud for accessibility
  • Add voice feedback to automated workflows or agents
  • Generate audio files programmatically from text
  • Test and compare different TTS providers in one tool

FAQ from mcp-say

Which API keys are required?

ElevenLabs API key for elevenlabs_tts, Google AI API key for google_tts, and OpenAI API key for openai_tts. The say_tts tool uses macOS built-in and requires no API key.

Can I use mcp-say on Windows or Linux?

The say_tts tool relies on the macOS say binary and works only on macOS. The other three cloud-based tools (ElevenLabs, Google, OpenAI) are platform-independent.

How do I prevent overlapping speech?

By default, TTS requests are sequential—only one plays at a time. Set MCP_TTS_ALLOW_CONCURRENT=true or use --sequential-tts=false to allow concurrent speech.

Can I save the audio to a file instead of playing it?

Yes. Set MCP_TTS_OUTPUT_DIR to a directory path. Optionally set MCP_TTS_NO_PLAY=true to skip playback and only save the file. Files are named tts_{timestamp}_{hash}.{ext} with formats AIFF (say), MP3 (ElevenLabs/OpenAI), WAV (Google).

What is the behavior for free-tier ElevenLabs API keys?

Free-tier ElevenLabs API keys can only use premade voices. Voice Library (community/professional) voices will return a 402 paid_plan_required error.

Frequently asked questions

Which API keys are required?

ElevenLabs API key for `elevenlabs_tts`, Google AI API key for `google_tts`, and OpenAI API key for `openai_tts`. The `say_tts` tool uses macOS built-in and requires no API key.

Can I use mcp-say on Windows or Linux?

The `say_tts` tool relies on the macOS `say` binary and works only on macOS. The other three cloud-based tools (ElevenLabs, Google, OpenAI) are platform-independent.

How do I prevent overlapping speech?

By default, TTS requests are sequential—only one plays at a time. Set `MCP_TTS_ALLOW_CONCURRENT=true` or use `--sequential-tts=false` to allow concurrent speech.

Can I save the audio to a file instead of playing it?

Yes. Set `MCP_TTS_OUTPUT_DIR` to a directory path. Optionally set `MCP_TTS_NO_PLAY=true` to skip playback and only save the file. Files are named `tts_{timestamp}_{hash}.{ext}` with formats AIFF (say), MP3 (ElevenLabs/OpenAI), WAV (Google).

What is the behavior for free-tier ElevenLabs API keys?

Free-tier ElevenLabs API keys can only use premade voices. Voice Library (community/professional) voices will return a `402 paid_plan_required` error.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

blacktop

More Other MCP servers

Mobile Mcp

mobile-next

Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)

5.4K

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K