Skip to content
MCP server

Mac Voice MCP

Talk to Claude out loud on a Mac, with speech recognition running on-device

Runs locally
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
0.10.0
Listing updated
4 days ago

Similar MCP servers

About Mac Voice MCP

Mac Voice MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Mac Voice MCP lets Claude speak through your Mac's speakers, wait for you to answer, and receive what you said as text. Transcription is done by whisper.cpp on your own machine and recordings are deleted after each turn, so no audio leaves the computer. A warm whisper.cpp server keeps the model loaded for quick transcription on Apple Silicon.

The server exposes two tools, speak_and_listen and voice_setup, plus a guided setup prompt and a hands-free voice_mode prompt. In Claude Code a plugin adds call mode, where the microphone stays open until you hang up and you can speak while Claude works; there is also an optional Voice Buddy status line and an optional Kokoro neural voice. A doctor command scores the whole pipeline as PASS, WARN or FAIL.

It needs a Mac and Node.js 22 or newer, and it asks before installing SoX, whisper.cpp or a speech model. The README warns that the microphone turns on whenever the tool is called, that misheard words can lead an assistant to act wrongly, and that the project is vibe-coded with no support guarantee.

Install

Run in a terminal

claude mcp add mac-voice-mcp -- npx -y mac-voice-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mac-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mac-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mac-voice-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mac-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mac-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-voice-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • VOICE_MCP_WHISPER_MODELwhisper.cpp model name (default base.en)
  • VOICE_MCP_LANGUAGESpoken language code, e.g. en, th, or auto
  • VOICE_MCP_END_SILENCE_MSPause length that ends your turn, in ms (default 1200)

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

speak_and_listen
Speaks a short message, listens for one turn and returns the transcript
voice_setup
Checks what is installed and installs missing pieces after you agree

What it does

On-device transcription
whisper.cpp runs locally and recordings are deleted after each turn.
Hands-free calls
A call mode keeps the mic open until you hang up.
Natural turn-taking
A soft tick marks the mic opening; no push-to-talk.
Voice options
Uses a macOS voice or the optional Kokoro neural voice.
Setup that asks first
Installs missing software only after you agree.
Doctor check
Scores setup, voice, transcription, speakers and mic.

Good for

  • Step away while a long task runs and answer decisions by voice
  • Review a pull request summary and approve it aloud
  • Talk a problem through instead of typing
  • Rest your hands while still directing the assistant

Pricing

Open source

Free, open-source personal project provided as is

Mac Voice MCP FAQ

What do I need?

A Mac, with Apple Silicon recommended, and Node.js 22 or newer.

Does audio leave my computer?

No; the README says speech recognition runs on the Mac.

Which languages work?

Set VOICE_MCP_LANGUAGE to a code such as en or th, or auto.

What if it cuts me off?

Raise VOICE_MCP_END_SILENCE_MS, for example to 2000.

Is Mac Voice MCP free?

Yes. Mac Voice MCP is open source, so you can use and self-host it for free.

How do I add Mac Voice MCP to Claude Code?

Run this command in your terminal: claude mcp add mac-voice-mcp -- npx -y mac-voice-mcp

What are the best alternatives to Mac Voice MCP?

The closest alternatives to Mac Voice MCP are Voicemode, Local Whisper, Heads-up, Edict and Toolpiper.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers