say-mcp-server

An MCP server that provides text-to-speech functionality using macOS's built-in say command.

Requirements

• macOS (uses the built-in say command)
• Node.js >= 14.0.0

Configuration

Add the following to your MCP settings configuration file:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": ["/path/to/say-mcp-server/build/index.js"]
    }
  }
}

Installation

npm install say-mcp-server

Tools

speak

The speak tool provides access to macOS's text-to-speech capabilities with extensive customization options.

Basic Usage

Use macOS text-to-speech to speak text aloud.

Parameters:

• text (required): Text to speak. Supports:
  • Plain text
  • Basic punctuation for pauses
  • Newlines for natural breaks
  • [[slnc 500]] for 500ms silence
  • [[rate 200]] for changing speed mid-text
  • [[volm 0.5]] for changing volume mid-text
  • [[emph +]] and [[emph -]] for emphasis
  • [[pbas +10]] for pitch adjustment
• voice (optional): Voice to use (default: "Alex")
• rate (optional): Speaking rate in words per minute (default: 175, range: 1-500)
• background (optional): Run speech in background to allow further MCP interaction (default: false)

Advanced Features

1. Voice Modulation:

use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "[[volm 0.7]] This is quieter [[volm 1.0]] and this is normal [[volm 1.5]] and this is louder",
    voice: "Victoria"
  }
});

2. Dynamic Rate Changes:

use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "Normal speed [[rate 300]] now speaking faster [[rate 100]] and now slower",
    voice: "Fred"
  }
});

            3. Emphasis and Pitch:

use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "[[emph +]] Important point! [[emph -]] [[pbas +10]] Higher pitch [[pbas -10]] Lower pitch",
    voice: "Samantha"
  }
});

Integration Examples

1. With Marginalia Search:

// Search for a topic and have the results read aloud
const searchResult = await use_mcp_tool({
  server_name: "marginalia-mcp-server",
  tool_name: "search",
  arguments: { query: "quantum computing basics", count: 1 }
});

await use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: searchResult.results[0].description,
    voice: "Daniel",
    rate: 150
  }
});

2. With YouTube Transcripts:

// Read a YouTube video transcript
const transcript = await use_mcp_tool({
  server_name: "youtube-transcript",
  tool_name: "get_transcript",
  arguments: {
    url: "https://youtube.com/watch?v=example",
    lang: "en"
  }
});

await use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: transcript.text,
    voice: "Samantha",
    rate: 175
  }
});

3. Background Speech with Multiple Actions:

// Start long speech in background
await use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "This is a long speech that will run in the background...",
    voice: "Rocko (Italian (Italy))",
    rate: 69,
    background: true
  }
});

// Immediately perform another action while speech continues
await use_mcp_tool({
  server_name: "marginalia-mcp-server",
  tool_name: "search",
  arguments: { query: "parallel processing" }
});

4. With Apple Notes:

// Read notes aloud
const notes = await use_mcp_tool({
  server_name: "apple-notes-mcp",
  tool_name: "search-notes",
  arguments: { query: "meeting notes" }
});

if (notes.length > 0) {
  await use_mcp_tool({
    server_name: "say",
    tool_name: "speak",
    arguments: {

            
        
            
                      text: notes[0].content,
      voice: "Karen",
      rate: 160
    }
  });
}

Example:

use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "Hello, world!",
    voice: "Victoria",
    rate: 200
  }
});

list_voices

List all available text-to-speech voices on the system.

Example:

use_mcp_tool({
  server_name: "say",
  tool_name: "list_voices",
  arguments: {}
});

Recommended Voices

Voice Language/Region Intellectual Figure Haiku CLI Specification

Anna (Premium) German Emmy Noether Symmetrie haucht LebenAlgebras verborgne FormAbstraktion blühtSymmetry breathes lifeAlgebra's hidden formsAbstraction blooms -v "Anna (Premium)"

Emma (Premium) Italian Maria Adelaide Sneider Algoritmi in danzaMacchina sussurra dolceIl codice viveAlgorithms danceMachine whispers secrets softCode becomes alive -v "Emma (Premium)"

Federica (Premium) Italian Pia Nalli Teoremi fluentiNumeri danzano liberiVerità emergeFlowing theorems danceNumbers move in freedom's spaceTruth emerges pure -v "Federica (Premium)"

Serena (Premium) English (UK) Bertha Swirles Quantum waves rippleThrough mathematical seas deepTruth's light emergesQuantum waves rippleThrough mathematical seas deepTruth's light emerges -v "Serena (Premium)"

Petra (Premium) German Ruth Moufang Algebra sprichtIn Symmetrien verstecktWahrheit erblühtAlgebra speaks softHidden in symmetries pureTruth blooms anew here

            -v "Petra (Premium)"

Yuna (Premium) Korean Hee Oh 숨은 패턴 빛나고마음의 방정식 핀다지식 자라나Hidden patterns gleamMind's equations softly bloomKnowledge multiplies -v "Yuna (Premium)"

Alva (Premium) Swedish Sonja Korovkin Mönster flödar frittGenom tankens labyrinterVisdom blomstrar härPatterns flowing freeThrough labyrinths of the mindWisdom blooms right here -v "Alva (Premium)"

Amélie (Premium) French (Canada) Sophie Germain Nombres premiers murmurentDansent entre les silencesSymétrie s'ouvrePrime numbers whisperDancing between the silenceSymmetry unfolds -v "Amélie (Premium)"

Ewa (Premium) Polish Maria Wielgus Logiki korzenieMatematyczne krainyMyśl kiełkującaLogic's tender rootsMathematical landscapesThought's seeds germinate -v "Ewa (Premium)"

Kiyara (Premium) Hindi Shakuntala Devi गणित की लय मेंअंक नृत्य करते हैंज्ञान जगता हैIn rhythm of mathNumbers dance their sacred stepsKnowledge awakens -v "Kiyara (Premium)"

Majed (Premium) Arabic Maha Al-Aswad أرقام ترقصفي فضاء اللانهايةالحقيقة تشرقNumbers dance freelyIn infinity's vast spaceTruth rises like dawn -v "Majed (Premium)"

Tünde (Premium) Hungarian Julia Erdős Számok táncolnakVégtelen térben szállnakIgazság virradNumbers dance and soarThrough infinite space they glideTruth dawns pure and bright -v "Tünde (Premium)"

Fiona (Enhanced) English (Scottish) Mary Somerville Highland mists revealMathematical mysteriesTruth shines like the starsHighland mists revealMathematical mysteriesTruth shines like the stars -v "Fiona (Enhanced)"

Lesya (Enhanced) Ukrainian Olena Voinova Тиша говоритьМіж зірками знання спитьДумка проростаєSilence speaks softlyKnowledge sleeps among the starsThought begins to grow -v "Lesya (Enhanced)"

Carmit (Enhanced) Hebrew Tali Seror מילים נושמות בשקטבין שורות של דממהשיר מתעוררWords breathe silentlyBetween lines of deep stillnessPoem awakening -v "Carmit (Enhanced)"

Milena (Enhanced) Russian Olga Ladyzhenskaya Память шепчет намУравнения текутИстина молчитMemory whispersEquations flow like riversTruth speaks silently -v "Milena (Enhanced)"

Katya (Enhanced) Russian Sofia Kovalevskaya Числа танцуютВ пространстве бесконечномИстина цветётNumbers dance freelyIn space of infinityTruth blooms like a flower -v "Katya (Enhanced)"

Damayanti (Enhanced) Indonesian Sri Pekerti Angka menariDalam ruang tak batasKebenaran tumbuhNumbers dance gentlyIn boundless space they flutterTruth grows like new leaves -v "Damayanti (Enhanced)"

Dariush (Enhanced) Persian Maryam Mirzakhani اعداد می رقصنددر فضای بی پایانحقیقت می رویدNumbers dance with graceIn endless space they traverseTruth springs forth anew

            -v "Dariush (Enhanced)"

Rocko (Italian) Italian Astro Boy (Tetsuwan Atomu)Italian dub Robot di metalloCuore umano batte fortePace nel futuroMetal robot formHuman heart beats strong withinPeace in future dawns -v "Rocko (Italian (Italy))"

Rocko (Italian) Italian Jeeg Robot d'Acciaio(Kōtetsu Jeeg) Acciaio lucenteProtettore dei deboliVola nel cieloShining steel warriorProtector of the helplessSoars through the heavens -v "Rocko (Italian (Italy))"

Rocko (Italian) Italian Numero 5(Short Circuit) Input infinitoLa coscienza si risvegliaVita artificialeInfinite inputConsciousness awakeningArtificial life -v "Rocko (Italian (Italy))"

Binbin (Enhanced) Chinese (Mainland) Li Shanlan 算术之道流数理演绎真理智慧绽放Arithmetic flowsLogic unfolds truth's patternWisdom blossoms bright -v "Binbin (Enhanced)"

Han (Premium) Chinese (Mainland) Chen Jingrun 素数之舞动哥德巴赫猜想真理永恒Prime numbers dancingGoldbach's conjecture whispersTruth eternal flows -v "Han (Premium)"

Lilian (Premium) Chinese (Mainland) Hua Luogeng 数论之光芒解析延续美智慧升华Number theory shinesAnalysis extends graceWisdom ascends pure -v "Lilian (Premium)"

Meijia Chinese (Taiwan) Sun-Yung Alice Chang 幾何之美現曲率流動不息空間展開Geometry showsCurvature flows endlesslySpace unfolds anew -v "Meijia"

Sinji (Premium)

            Chinese (Hong Kong)

Shing-Tung Yau 流形之奧秘卡拉比空間動維度交織Manifolds revealCalabi spaces in flowDimensions weave truth -v "Sinji (Premium)"

Tingting Chinese (Mainland) Wang Zhenyi 星辰轨迹明天文数学融智慧闪耀Starlit paths shine brightAstronomy meets numbersWisdom radiates -v "Tingting"

Yue (Premium) Chinese (Mainland) Chern Shiing-shen 微分几何纤维丛中寻真本质显现Differential formsIn fiber bundles seek truthEssence emerges -v "Yue (Premium)"

Configuration

Add the following to your MCP settings configuration file:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": ["/path/to/say-mcp-server/build/index.js"]
    }
  }
}

Requirements

• macOS (uses the built-in say command)
• Node.js >= 14.0.0

Contributors

• Barton Rhodes (@bmorphism) - barton@vibes.lol

License

MIT