murmur-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

Related MCP server: VOICEVOX MCP Server

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.