Get started

Quick start with bunx

The fastest way to try VoiceLayer. Runs the MCP server directly without installing.

bunx voicelayer-mcp

*Requires Bun runtime. For npm: npx voicelayer-mcp.

Configure MCP

Add VoiceLayer to your Claude Code MCP configuration for persistent access.

// ~/.claude/settings.json
{
  "mcpServers": {
    "qa-voice": {
      "command": "bunx",
      "args": ["voicelayer-mcp"]
    }
  }
}

Install prerequisites

For voice recording: sox (brew install sox). For local transcription: whisper.cpp (brew install whisper-cpp) plus a GGML model file. Cloud transcription via Wispr Flow is available as a fallback.

brew install sox whisper-cpp
# Download a model:
curl -L -o ~/.cache/whisper/ggml-large-v3-turbo.bin \
  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin

*macOS: grant microphone access to your terminal app in System Settings > Privacy > Microphone.

Try your first voice command

Use the announce mode for a quick fire-and-forget test. The agent will speak the message aloud.

// In a Claude Code session:
voice_speak("Hello from VoiceLayer!")