About Murmur
Murmur CLI provides command-line and MCP access to the Murmur macOS app for offline text-to-speech and voice cloning. It generates speech locally, so text is not uploaded.
Key features
- 01Generate speech from text or files
- 02Choose voices and speech models
- 03Install available models
- 04Batch jobs from a manifest
- 05Inspect job status
Use cases
- 01Create local voiceovers for project scripts
- 02Generate audio from chapter files
- 03Run batch speech generation for scenes
MCP support
The package includes an MCP server that lets compatible clients request voice generation on the Mac running Murmur.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEmurmur-cli
Command line and MCP access to Murmur, an offline text-to-speech and voice cloning app for Mac. Speech is generated on your own computer; your text is never uploaded.
This package is a small launcher. It finds the signed CLI that ships inside Murmur.app and runs it, so you can call murmur from any project, npm script or AI agent.
Requirements
- macOS 15 or later (Apple Silicon or Intel)
- The Murmur app, free to download: https://www.murmurtts.com/download/latest
- Automation turned on once in Murmur > Settings > Automation
Install
npm install -g murmur-cli
murmur status
Or run it without installing:
npx murmur-cli status
Generate speech
murmur generate --text "Welcome back. Today we're building a local voice workflow." \
--voice af_bella --speed 0.95 --output audio/intro.wav
murmur generate --input scripts/chapter-01.txt --model kokoro --output audio/chapter-01.m4a
Other commands:
murmur models [--json]
murmur models install MODEL_ID
murmur voices [--model ID] [--json]
murmur batch --manifest scenes.json
murmur jobs get JOB_ID
Run murmur --help for every option.
Use with AI agents (MCP)
Murmur includes an MCP server, so Claude Code, Codex, Cursor and other MCP clients can generate voiceovers on your Mac.
claude mcp add --transport stdio --scope user murmur -- npx -y murmur-cli mcp serve
{
"mcpServers": {
"murmur": { "command": "npx", "args": ["-y", "murmur-cli", "mcp", "serve"] }
}
}
Custom app location
If Murmur.app is not in /Applications or ~/Applications, point to the helper:
export MURMUR_HELPER="/path/to/Murmur.app/Contents/Helpers/murmur"
Docs
Full CLI and MCP guide: https://www.murmurtts.com/docs/automation
The launcher in this package is MIT licensed. The Murmur app has its own license, with a free plan and a one-time Pro upgrade.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.