Mac Voice MCP
Talk to Claude out loud on a Mac, with speech recognition running on-device
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mac-voice-mcp": {
"command": "npx",
"args": [
"-y",
"mac-voice-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mac-voice-mcp": {
"command": "npx",
"args": [
"-y",
"mac-voice-mcp"
]
}
}
}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 autoVOICE_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.