# Mac Voice MCP

> Mac Voice MCP is an open-source MCP server for productivity. Talk to Claude out loud on a Mac, with speech recognition running on-device. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/jeet0007/mac-voice-mcp
- **MCP Registry name:** io.github.jeet0007/mac-voice-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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.

## Alternatives

- [Voicemode](https://ai-powered.com/mcp/voicemode): Voicemode is an open-source MCP server for developer tools.
- [Local Whisper](https://ai-powered.com/mcp/local-whisper): Local Whisper is an MCP server for design and media.
- [Heads-up](https://ai-powered.com/mcp/heads-up): Heads-up is a free MCP server for developer tools.
- [Edict](https://ai-powered.com/mcp/edict): Edict is an MCP server for design and media.
- [Toolpiper](https://ai-powered.com/mcp/toolpiper): Toolpiper is a freemium MCP server for developer tools.
- [Lexicon](https://ai-powered.com/mcp/lexicon-2): Lexicon is a free MCP server for developer tools.
- [Yap](https://ai-powered.com/mcp/yap): Yap is an open-source MCP server for design and media.
- [Kimiko](https://ai-powered.com/mcp/kimiko): Kimiko is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/mac-voice-mcp
