Mcp Speak
About
This is a Model Context Protocol (MCP) server that provides text-to-speech capabilities using the native MacOS say command. It allows AI agents (like Google Antigravity, Claude Desktop, Cursor, Windsurf, or Codex) to speak to you directly.
Details
- Author
- fellowgeek
- GitHub stars
- 4
- Downloads
- 443
- Categories
- Productivity
Jump to
- Interactive Setup Wizard: Simply run python3 setup.py to generate persona instructions for your favorite AI editor (AGENTS.md, GEMINI.md, CLAUDE.md, .cursorrules).
- Auto-Provisioning Virtual Environment: Uses run.sh to automatically create a local .venv and install dependencies if missing.
- Modular Personas: Standardized persona guidelines stored in the personas/ folder.
- Sequential Speech Queue: Automatically handles back-to-back speech requests without overlapping audio.
- Blocking & Non-Blocking Support: Choose between waiting for speech to finish (speak) or continuing immediately (speak_non_blocking).
- Native MacOS Integration: Uses the built-in say command for high-quality, low-latency speech.
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
Mcp SpeakCommand (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
Running python3 setup.py automatically configures the MCP server in your selected tool's configuration file!
Manual Configuration (Optional)
If you prefer to configure your MCP client manually, add the "voice" server pointing to run.sh:
1. Google Antigravity (AGY)
Edit~/.gemini/antigravity/mcp_config.json:
{
"mcpServers": {
"voice": {
"command": "/ABSOLUTE/PATH/TO/run.sh"
}
}
}
2. Claude CLI (Claude Code)
claude mcp add --scope user voice -- /ABSOLUTE/PATH/TO/run.sh
3. Claude Desktop
Edit~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"voice": {
"command": "/ABSOLUTE/PATH/TO/run.sh"
}
}
}
4. Cursor IDE
Edit~/.cursor/mcp.json:
{
"mcpServers": {
"voice": {
"command": "/ABSOLUTE/PATH/TO/run.sh"
}
}
}
5. Windsurf Editor
Edit~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"voice": {
"command": "/ABSOLUTE/PATH/TO/run.sh"
}
}
}
6. Codex Desktop
Edit~/.codex/config.toml:
[mcp_servers.voice]
command = "/ABSOLUTE/PATH/TO/run.sh"
7. Codex CLI
codex mcp add voice -- /ABSOLUTE/PATH/TO/run.sh
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp speak": {
"voice": {
"command": "/ABSOLUTE/PATH/TO/run.sh"
}
}
}
}McpServers
{
"voice": {
"command": "/ABSOLUTE/PATH/TO/run.sh"
}
}Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
